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Preface 








Java Programming, Seventh Edition, provides the beginning programmer with a guide to 
developing applications using the Java programming language. Java is popular among 
professional programmers because it can be used to build visually interesting graphical user 
interface (GUI) and Web-based applications. Java also provides an excellent environment for 
the beginning programmer—a student can quickly build useful programs while learning the 
basics of structured and object-oriented programming techniques. 


This textbook assumes that you have little or no programming experience. This book 
provides a solid background in good object-oriented programming techniques and introduces 
terminology using clear, familiar language. The writing is nontechnical and emphasizes good 
programming practices. The programming examples are business examples; they do not 
assume a mathematical background beyond high-school business math. In addition, the 
examples illustrate only one or two major points; they do not contain so many features 
that you become lost following irrelevant and extraneous details. The explanations in this 
textbook are written clearly in straightforward sentences, making it easier for native and 
non-native English speakers alike to master the programming concepts. Complete, working 
programs appear frequently in each chapter; these examples help students make the 
transition from the theoretical to the practical. The code presented in each chapter can also 
be downloaded from the publisher’s Web site, so students can easily run the programs and 
experiment with changes to them. 


The student using Java Programming, Seventh Edition, builds applications from the bottom 
up rather than starting with existing objects. This facilitates a deeper understanding of the 
concepts used in object-oriented programming and engenders appreciation for the existing 
objects students use as their knowledge of the language advances. When students complete 
this book, they will know how to modify and create simple Java programs, and they will have 
the tools to create more complex examples. They also will have a fundamental knowledge of 
object-oriented programming, which will serve them well in advanced Java courses or in 
studying other object-oriented languages such as C++, C#, and Visual Basic. 


Organization and Coverage 


Java Programming, Seventh Edition, presents Java programming concepts, enforcing good 
style, logical thinking, and the object-oriented paradigm. Objects are covered right from the 
beginning, earlier than in many other textbooks. You create your first Java program in 
Chapter 1. Chapters 2, 3, and 4 increase your understanding of how data, classes, objects, and 
methods interact in an object-oriented environment. 


Chapters 5 and 6 explore input and repetition structures, which are the backbone of 
programming logic and essential to creating useful programs in any language. You learn the 
special considerations of string and array manipulation in Chapters 7, 8, and 9. 


Chapters 10, 11, and 12 thoroughly cover inheritance and exception handling. Inheritance is 
P the object-oriented concept that allows you to develop new objects quickly by adapting the 
| xxii ae ; ' ae 
features of existing objects; exception handling is the object-oriented approach to handling 
errors. Both are important concepts in object-oriented design. Chapter 13 provides 
information on handling files so you can permanently store and retrieve program output. 





Chapters 14 and 15 introduce GUI Swing components—Java’s visually pleasing, user-friendly 
widgets—and their layout managers. Chapters 16 and 17 show you ways to provide 
interactive excitement using graphics, applets, images, and sound. 


Features 
The following features are new for the Seventh Edition: 


e YOU DOIT: In each chapter, step-by-step exercises help students create multiple working 
programs that emphasize the logic a programmer uses in choosing statements to include. 
These sections provide a means for students to achieve success on their own—even those 
in online or distance learning classes. Previous editions of the book contained a long, 
multipart “You Do It” section at the end of each chapter, but in this edition, more and 
shorter sections follow important chapter topics so the student can focus on one new 
concept at a time. 


e CASES: Each chapter contains two running case problems. These cases represent projects 
that continue to grow throughout a semester using concepts learned in each new chapter. 
Two cases allow instructors to assign different cases in alternate semesters or to divide 
students in a class into two case teams. 


e PROGRAMMING EXERCISES: Each chapter concludes with meaningful programming 
exercises that provide additional practice of the skills and concepts learned in the chapter. 
These exercises vary in difficulty and are designed to allow exploration of logical 
programming concepts. Each chapter contains several new programming exercises not 
seen in previous editions. 


e INCREASED EMPHASIS ON STUDENT RESEARCH: In this edition, the student frequently 
is directed to the Java Web site to investigate classes and methods. Computer languages 
evolve, and programming professionals must understand how to find the latest language 
improvements. This book encourages independent research. 


Additionally, Java Programming, Seventh Edition, includes the following features: 


e OBJECTIVES: Each chapter begins with a list of objectives so you know the topics that will 
be presented in the chapter. In addition to providing a quick reference to topics covered, 
this feature provides a useful study aid. 
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e NOTES: These highlighted tips provide additional information—for example, an 
alternative method of performing a procedure, another term for a concept, background 
information on a technique, or a common error to avoid. 


e FIGURES: Each chapter contains many figures. Code figures are most frequently 25 lines 
or fewer, illustrating one concept at a time. Frequent screen shots show exactly how xxiii 
program output appears. Callouts appear where needed to emphasize a point. [ 





e COLOR: The code figures in each chapter contain all Java keywords in blue. This helps 
students identify keywords more easily, distinguishing them from programmer-selected 
names. 


e FILES: More than 200 student files can be downloaded from the publisher’s Web site. 
Most files contain the code presented in the figures in each chapter; students can run 
the code for themselves, view the output, and make changes to the code to observe the 
effects. Other files include debugging exercises that help students improve their 
programming skills. 


e TWO TRUTHS AND ALIE: A short quiz reviews each chapter section, with answers 
provided. This quiz contains three statements based on the preceding section of text—two 
statements are true and one is false. Over the years, students have requested answers 
to problems, but we have hesitated to distribute them in case instructors want to use 
problems as assignments or test questions. These true-false quizzes provide students with 
immediate feedback as they read, without “giving away” answers to the multiple-choice 
questions and programming exercises. 


e DONTDOIT: This section at the end of each chapter summarizes common mistakes and 
pitfalls that plague new programmers while learning the current topic. 


e KEY TERMS: Each chapter includes a list of newly introduced vocabulary, shown in the 
order of appearance in the text. The list of key terms provides a short review of the major 
concepts in the chapter. 


e SUMMARIES: Following each chapter is a summary that recaps the programming 
concepts and techniques covered in the chapter. This feature provides a concise means for 
students to check their understanding of the main points in each chapter. 


e REVIEW QUESTIONS: Each chapter includes 20 multiple-choice questions that serve as a 
review of chapter topics. 


e GAME ZONE: Each chapter provides one or more exercises in which students create 
interactive games using the programming techniques learned up to that point; 70 game 
programs are suggested in the book. The games are fun to create and play; writing them 
motivates students to master the necessary programming techniques. Students might 
exchange completed game programs with each other, suggesting improvements and 
discovering alternate ways to accomplish tasks. 


e GLOSSARY: A glossary contains definitions for all key terms in the book, presented in 
alphabetical order. 
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e APPENDICES: This edition includes useful appendices on working with the Java platform, 
data representation, formatting output, generating random numbers, and creating Javadoc 
comments. 


e QUALITY: Every program example, exercise, and game solution was tested by the author 
and then tested again by a quality assurance team using Java Standard Edition (SE) 7, the 
most recent version available. 


CourseMate 


The more you study, the better the results. Make the most of your study time by accessing 
everything you need to succeed in one place. Read your textbook, take notes, review 
flashcards, watch videos, and take practice quizzes online. CourseMate goes beyond the book 
to deliver what you need! Learn more at www.cengage.com/coursemate. 


The Java Programming CourseMate includes: 


e Debugging Exercises: Four error-filled programs accompany each chapter. By 
debugging these programs, students can gain expertise in program logic in general and the 
Java programming language in particular. 


e Video Lessons: Each chapter is accompanied by at least three video lessons that help to 
explain important chapter concepts. These videos were created and narrated by the 
author. 


e Interactive Study Aids: An interactive eBook, quizzes, flashcards, and more! 


Instructors may add CourseMate to the textbook package, or students may purchase 
CourseMate directly at www.CengageBrain.com. 


Instructor Resources 


The following teaching tools are available for download at our Instructor Companion Site. 
Simply search for this text at login.cengage.com. An instructor login is required. 


e Electronic Instructor’s Manual: The Instructor’s Manual that accompanies this 
textbook includes additional instructional material to assist in class preparation, including 
items such as Overviews, Chapter Objectives, Teaching Tips, Quick Quizzes, Class 
Discussion Topics, Additional Projects, Additional Resources, and Key Terms. A sample 
syllabus is also available. Additional exercises in the Instructor’s Manual include: 


o Tough Questions: Two or more fairly difficult questions that an applicant might 
encounter in a technical job interview accompany each chapter. These questions are 
often open-ended; some involve coding and others might involve research. 


o Up for Discussion: A few thought-provoking questions concerning programming in 
general or Java in particular supplement each chapter. The questions can be used to 
start classroom or online discussions, or to develop and encourage research, writing, 
and language skills. 
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o Programming exercises and solutions: Each chapter is accompanied by several 
programming exercises to supplement those offered in the text. Instructors can use 
these exercises as additional or alternate assignments, or as the basis for lectures. 


e ExamView: This textbook is accompanied by ExamView, a powerful testing software 
package that allows instructors to create and administer printed, computer (LAN-based), 
and Internet-based exams. ExamView includes hundreds of questions that correspond to 
the topics covered in this text, enabling students to generate detailed study guides that 
include page references for further review. The computer-based and Internet testing 
components allow students to take exams at their computers, and they save the instructor 
time by grading each exam automatically. These test banks are also available in 
Blackboard-compatible formats. 
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e PowerPoint Presentations: This text provides PowerPoint slides to accompany each 
chapter. Slides may be used to guide classroom presentations, to make available to 
students for chapter review, or to print as classroom handouts. Files are provided for every 
figure in the text. Instructors may use the files to customize PowerPoint slides, illustrate 
quizzes, or create handouts. 


e Solutions: Solutions to “You Do It” exercises and all end-of-chapter exercises are 
available. Annotated solutions are provided for some of the multiple-choice Review 
Questions. For example, if students are likely to debate answer choices or not understand 
the choice deemed to be the correct one, a rationale is provided. 
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Read This Before 
You Begin 


The following information will help you as you prepare to use this textbook. 


To the User of the Data Files 


To complete the steps and projects in this book, you need data files that have been created 
specifically for this book. Your instructor will provide the data files to you. You also can 
obtain the files electronically from www.CengageBrain.com. Find the ISBN of your title on 
the back cover of your book, then enter the ISBN in the search box at the top of the 
Cengage Brain home page. You can find the data files on the product page that opens. Note 
that you can use a computer in your school lab or your own computer to complete the 
exercises in this book. 


Using Your Own Computer 
To use your own computer to complete the steps and exercises, you need the following: 


e Software: Java SE 7, available from www.oracle.com/technetwork/java/index.html. Although 
almost all of the examples in this book will work with earlier versions of Java, this book was 
created using Java 7. The book clearly points out the few cases when an example is based on 
Java 7 and will not work with earlier versions of Java. You also need a text editor, such as 
Notepad. A few exercises ask you to use a browser, such as Internet Explorer. 


e Hardware: If you are using Windows 7, the Java Web site suggests at least 128 MB 
of memory and at least 98 MB of disk space. For other operating system requirements, 
see http://java.com/en/download/help. 





Features 


This text focuses on helping students become better programmers and understand 
Java program development through a variety of key features. In addition to chapter 
Objectives, Summaries, and Key Terms, these useful features will help students 

regardless of their learning styles. XXVI 






























Analyzing a Java Application that Produces Console Output Ee 







YOU DO IT sections walk 
students through program 


a You Dot 
development step by step. 


Your First Application (2 


Now that you understand the basics of an application written in Java, you are ready to 
enter your own Java application into a text editor. It is a tradition among programmers 
that the first program you write in any language produces “Hello, world!” as its output. 
You will create such a program now. You can use any text editor, such as Notepad or 
TextPad, or a development environment, such as jGRA 


It is best to use the simplest available text editor when wri 
GD processing programs save documents as much larger files 


as font styles and margin settings, which the Java compile 















CHAPTER 1 Creating Java Programs” 









1. Start any text editor, and then open a new doc 




















name is still stored on your computer. Before the new source code can execute, you must do 


2. Type the class header as follows: the following: 


public.class Hello 1. Save the file with the changes (using the same filename). 


In this example, the class name is He11o. Yol 
want for the class. If you choose Hello, you al 
Hello, and not as hello, because Java is case : 


2. Compile the class with the javac command. (Actually, you are recompiling the class.) 





3. Interpret the class bytecode and execute the class using the java command. 





3. Press Enter once, type {, press Enter again, a Figure 1-19 shows the new output. 


main© method between these curly braces. A 
convention used in this book is to place each ct 
align opening and closing curly brace pairs witl 
makes your code easier to read. 







When you recompile a class, the original 
version of the compiled file with the .class 
extension is replaced, and the original 
version no longer exists. When you modify 
a class, you must decide whether you want 
to retain the original version. If you do, you 
must give the new version a new class 
name and a new filename. 






4. As shown in the shaded portion of Figure 1-9, < 
between the curly braces, and then type a set 





Figure 1-19 Execution of modified First class 



















NOTES p rovide Once in a while, when you make a change to a Java class and then recompile and execute it, the old version 
EXele| nite) n a | nfo rmati on (stringt ) still runs. The simplest solution is to delete the .class file and compile again. Programmers call this creating a 
\_—— n(String args 


clean build. 
for example, another 
feyers 146) 8) Ta the eyeye).¢ th at Watch the video Compiling and Executing a Program. 
5 shell for the He] 10 class 
expands on a topic, or a 
ecting Logical Errors 


common error 1K) watch des syntax errors, a second kind of error occurs when the syntax of the program is correct 
out for. he program compiles but produces incorrect results when you execute it. This type 

‘ ror is a logic error, which is often more difficult to find and resolve. For example, 

‘e 1-20 shows the output of the execution of a successfully compiled program named 
tBadOutput. If you glance at the output too quickly, you might not notice that Java is 
i}pelled. The compiler does not find spelling errors within a literal string; it is legitimate 
‘oduce any combination of letters as output. 
er examples of logic errors include 



















The author does an excellent 
job clarifying what my VIDEO LESSONS help 

students have historically had explain important chapter 

trouble with. concepts. Videos are part 

—Lee Cottrell, Bradford of the text’s enhanced oo ee 
School, Pittsburgh CourseMate site. 
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TWO TRUTHS & ALIE quizzes appear 
after each chapter section, with 

answers provided. The quiz contains 
three statements based on the preceding 
shies civ tie declan Suscasnetidinees section of text—two statements are 
Pe Greece true and one is false. Answers give 


program of bytecode. 


4. lava programs that te embedded ina Web page are ead applets, wile immediate feedback without “giving away” 


stand-alone programs are called Java applications. 


I AiooEeN NE RIDRAocIoT ERMAN! answers to the multiple-choice questions 
Yypiym ‘Teanau Ajjenjoayyose aq 0} padojanap Sem ener “TH SI JUUIA}eIS asje} ay] “ F 
and programming problems later in 


Analyzing a Java Application that Produces the chapter. Students also have the option 
Console Output 


At first glance, even the simplest Java application involves a fair amount of confusing syntax. ane) take these ol padets electronically 


Consider the application in Figure 1-4, This program is written on seven lines, and its only : 
Tak te ele "Pst or aplication onthe sree through the enhanced CourseMate site. 


public class First 


CHAPTER 1 Creating Java Programs 





with elements such as menus, toolbars, and dialog boxes, Console applications are the 
easiest applications to create; you start using them in the next section, 





Features of the Java Programming Language 


XXVili 


























7. Save, compile, and execute the program. Now, the fractional portion of the result 

public static void main(String[] args) is omitted again. That's because the result of sum /2 is calculated first, and the 

{ result is an integer. Then the whole-number result is cast to a double and assigned 
} to a doub1e—but the fractional part of the answer was already lost and casting is 

} too late. Remove the newly added parentheses, save the program, compile it, and 

execute it again to confirm that the fractional part of the answer is reinstated. 


. As an alternative to the explicit cast in the division statement in the 
ArithmeticDemo program, you could write the average calculation as follows: 


average = sum / 2.0; 


In this calculation, when the integer sum is divided by the double constant 2.0, 
the result is a double. The result then does not require any cast to be assigned 
to the double average without loss of data. Try this in your program. 


9. Go to the Java Web site (www.oracle.com/technetwork/java/index.htm)), 
select Java APIs, and then select Java SE 7. Scroll through the list of 
All Classes, and select PrintStream, which is the data type for the out object 
used with the printin() method. Scroll down to view the list of methods in the 
Method Summary. As you did in a previous exercise, notice the many versions of 
the print© and printIn@ methods, including ones that accept a String, an int, 
and a long. Notice, however, that no versions accept a byte or a short. That's 
because when a byte or short is sent to the print() or printIn¢) method, it is 
automatically promoted to an int, so that version of the method is used. 









System.out.printin("First Java application"); 











































Figure 1-4 The First class 
When you see program code in figures in this book, Java Keywords as well as true, false, and nul are 


blue, and all other program elements are black. A complete list of Java keywords is shown later in this 
chapter. 


download so that you can execute the programs on your own computer. 


G ‘The code for every complete program shown in this book is available in a set of student fles you can 


| DY @) \\ Ml i BL OM W Mixcy-Youulo)aicura yma atomsyare| 
: 2 Don't Do It 
of each chapter list advice for ss iio age Pepi hoa altar ye tn ep 


avoiding common programming erro dia corte ea fas chan ndenescaane wah ete 


without following the constant with an uppercase or lowercase F, By default, constant 
floating-point values are doubles. 










© Don't try to use a Java keyword as an identifier for a variable or constant. Table 1-1 in 
Chapter 1 contains a list of Java keywords. 

© Don't attempt to assign a constant value under —2,147,483,648 or over +2,147,483,647 to a 
‘Jong variable without following the constant with an uppercase or lowercase L. By default, 
constant integers are ints, and a value under —2,147,483,648 or over 2,147,483,647 is too 
large to be an int. 









Using the Scanner Class to Accept Keyboard input J 


It is legal to write a single prompt that requests multiple input values—for example, “Please 
center your age, area code, and zip code.” The user could then enter the three values separated 
with spaces, tabs, or Enter key presses. The values would then be interpreted as separate 
tokens and could be retrieved with three separate nextInt() method calls, However, asking a 
user to enter multiple values often leads to mistakes. This book will follow the practice of 


using a separate prompt for each input value required. [7 


Pitfall: Using nextLine() Following One of the 
Other Scanner Input Methods 


You can encounter a problem when you use one of the numeric Scanner class retrieval 
methods or the next () method before you use the nextLine() method, Consider the 
program in Figure 2-19. It is identical to the one in Figure 2-17, except that the user is 
asked for an age before being asked for a name. (See shading.) Figure 2-20 shows a typical 


iat THE DON’T DO IT ICON illustrates 
how NOT to do something—for 
example, having a dead code 

path in a program. This icon 




























« Don't assume that you must divide numbers as a step to determining a remainder; the 
remainder operator (% ) is all that’s needed, 



















Don't Do it 
‘import java.util.Scanner; Hf you accept nur 
public class GetUserInfo2 


public static void main(String[] args) 
z 


String name; 
int age; 
Scanner inputDevice = new Scanner (sf 
System.out.print("Please enter y6 
age = inputDevice.nextInt(; 
System.out.print("Please enter your name >>"); 
name = inputDevici 
System.out.printIn: 
"and you are" + age +" years old."); 
EJ 


; 


provides a visual jolt to the studen 
emphasizing that particular figures 
are NOT to be emulated and making 
students more careful to recognize 
problems in existing code. 











Figure 2-19 The GetUserInfo2 class 





Figure 2-20 Typical execution of the GetUserInfo2 program 
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Assessment 


I find the flow of information superior 
to [that of] other texts. 


—Susan Peterson, 
Henry Ford Community College 


PROGRAMMING EXERCISES provide 
opportunities to practice concepts. These Xxix 
exercises increase in difficulty and allow 
students to explore each major 








programming concept presented in the 
chapter. Additional programming 
exercises are available in the Instructor's 
Resource Kit. 











Review Questions 





Review Questions 


1. A sequence of characters enclosed within double quotation marks is a ____. 





a, symbolic string c. prompt 

b. literal string d. command 385 
2. To create a String object, you can use the keyword _______ before 

the constructor call, but you are not required to use this format. 

a. object c. char 

b. create d. new 


3. A String variable name is a 











a. reference c. constan 
b. value d. literal 
Advanced Arr: 
4, The term that programmers use to describe objects th: CHARTERIS enced irageoncents 
changed is 
a. irrevocable c. immute Exercises 
b. nonvolatile d. stable 


[__] Programming Exercises 


5. Suppose that you declare two String objects as: 





String word1 = new StringC"happy"); 492 1. Write an application containing an array of 10 String values, and display them 

String word2; in ascending order. Save the file as SortStrings.java. 
When you ask a user to enter a value for word2, if the u: 2. a. The mean ofa list of numbers is its arithmetic average. The median of a list is its 
F S 
of word1 == word2 is —______. middle value when the values are placed in order. For example, if a list contains 
ee c. illegal 1,4, 7, 8, and 10, then the mean is 6 and the median is 7. Write an application 
that allows you to enter five integers and displays the values, their mean, and 
b. false 4, cunkriow their median, Save the file as MeanMedian,java. 

6. If you declare two String objects as: b. Revise the MeanMedian class so that the user can enter any number of 
String word1 = new String("happy"); values up to 20. If the list has an even number of values, the median is the 
String word2 = new String("happy") : numeric average of the values in the two middle positions. Save the file as 

MeanMedian2.java. 


the value of word1. equals (word2) is . 

7 3. a. Radio station JAVA wants a class to keep track of recordings it plays. Create 
a true c. illegal a class named Recording that contains fields to hold methods for setting and 
b. false d.unknow getting a Recording’s title, artist, and playing time in seconds. Save the file as 


Recording,java. 
7. The method that determines whether two String obje 
regardless of case, is. b. Write an application that instantiates five Recording objects and prompts 


the user for values for the data fields. Then prompt the user to enter which 
field the Recordings should be sorted by—song title, artist, or playing time. 
b. toUpperCase() d. equals: Perform the requested sort procedure, and display the Recording objects. 
Save the file as RecordingSort.java. 


4. In Chapter 8, you created a Salesperson class with fields for an ID number and 
sales values. Now, create an application that allows a user to enter values for an 
array of seven Salesperson objects. Offer the user the choice of displaying the 
objects in order by either ID number or sales value. Save the application as 
SalespersonSort.java. 


a, equal sNoCase() c. equals: 








5. In Chapter 8, you created a Salesperson class with fields for an ID number and 
sales values, Now, create an application that allows you to store an array that 


datab: f ber of Sal bj 20. While th 
REVIEW QUESTIONS test nee dete ta cola ir dues optonnstoacd arczanl tole dnaliae 
stu dent CO m p re hen S io n of the to delete a record from the database, or to change a record in the database. 


Then proceed as follows: 


e Ifthe user selects the add option, issue an error message if the database is full. 
Otherwise, prompt the user for an ID number. If the ID number already exists 
in the database, issue an error message. Otherwise, prompt the user for a sales 
value, and add the new record to the database. 


major ideas and techniques 
presented. Twenty questions 
follow each chapter. 
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Using Methods, Classes, and Objects DEBUGGING EXERCISES are 
ie Aer reading the chapter Making edison you willbe able to have the game included with each chapter because 


determine the higher card. For now, just observe how the card values change as you ae ae 
execute the program multiple times. Save the application as PickTwoCards.java. examining programs c ralucers)| NF elalel 
Ye the Math. random() function to ate id iber. The functic i] ly a cl 3 s G § 
G and method name cjest—so you now the random meted rast be asiaicetiod. Closely is a crucial programming skill. 
2. Computer games oten contain diferent characters ot ereture, For example, you Students can download these exercises 
might design a game in which alien beings possess specific characteristics such as is 
color, number of eyes, or number of lives. Design a character for a game, creating a . . 
at www.CengageBrain.com and through 
class to hold at least three attributes for the character. Include methods to get and t h c M t “i | bl f th 5 t t 
e€ LourselWate avaliable tor this text. 


set each of the character’s attributes. Save the file as MyCharacter.java. Then 

write an application in which you create at least two characters. In turn, pass each s 

character to a display method that displays the character's attributes. Save the 

coe reo intr eae These files are also available to 


Q A instructors through login.cengage.com. 
a. 






















































176 





se Problems 


Carly’s Catering provides meals for parties and special events. In Chapter 2, 
you wrote an application that prompts the user for the number of guests 
attending an event, displays the company motto with a border, and then 
displays the price of the event and whether the event is a large one. Now 
modify the program so that the main() method contains only three executable 
statements that each call a method as follows: 


e The first executable statement calls a public static int method that 
prompts the user for the number of guests and returns the value to the 
main() method. 





e The second executable statement calls a public static vo 
displays the company motto with the border. 





Exercises 





e The last executable statement passes the number of guests 
static void method that computes the price of the event 
price, and displays whether the event is a large event. b. 








eate a class named TestPainting whose main() method declares three 
Kinting items. Create a method that prompts the user for and accepts values 
for two of the Painting objects, and leave the third with the default values 
supplied by the constructor. Then display each completed object. Finally, display 
a message that explains the gallery commission rate. Save the application as 


TestPainting,java. 






Save the file as CarlysEventPriceWithMethods.java. 
b. Create a class to hold Event data for Carly’s Catering, The cla 





© Two public final static fields that hold the price per gue 
cutoff value for a large event (50 guests) 


e Three private fields that hold an event number, number ¢ + ‘ 
event, and the price. The event number is stored as a Strin % Debugging Exercises - 
plans to assign event numbers such as M312. 1. Each of the following files saved in the Chapter03 folder in your downloadable 

student files has syntax and/or logic errors. In each case, determine and fix the 

problem. After you correct the errors, save each file using the same filename 
preceded with Fix. For example, DebugThreel java will become 

FixDebugThreel java. 





DebugThreel java 
DebugThree2java 
DebugThree3.java 


CASE PROBLEMS provide opportunities 

to build more detailed programs that ie A ee Te 
continue to incorporate increasing FS IER! 
functionality throughout the book. 


aoe 





Oy Game Zone 2 
1. 


g cards are used in many computer games, including versions of such classics 
‘solitaire, hearts, and poker. Design a Card class that contains a character data field 
td hold a suit (s for spades, h for hearts, d for diamonds, or c for clubs) and an integer 
data field for a value from 1 to 13, (When you learn more about string handling in 
the chapter Characters, Strings, and the StringBui Ider, you can modify the class to 
hold words for the suits, such as spades or hearts, as well as words for some of the 
values—for example, ace or king.) Include get and set methods for each field. Save 
the class as Card.java. 


Write an application that randomly selects two playing cards and displays their 
values. Simply assign a suit to each of the cards, but generate a random number 
for each card’s value. Appendix D contains information on generating random 
numbers. To fully understand the process, you must learn more about Java 
classes and methods. However, for now, you can copy the following statements to 
generate a random number between 1 and 13 and assign it to a variable: 

final int CARDS_IN SUIT = 13; 

myValue = (Cint)(Math.random() * 100) % CARDS_IN SUIT + 1); 


GAME ZONE EXERCISES are included 
at the end of each chapter. Students can 





create games as an additional entertaining 
way to understand key programming 
concepts. 
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Creating Java 
Programs 


In this chapter, you will: 


DY=vilarew ey-bsilom 0) aeyo4e-l a nlanliavcamecyanaliare)(eysay 


(©) 


Compare procedural and object-oriented programming 


(©) 


Describe the features of the Java programming language 


(©) 


Analyze a Java application that produces console output 


(©) 


Compile a Java class and correct syntax errors 


(©) 


Run a Java application and correct logical errors 


(©) 


Add comments to a Java class 


(©) 


Create a Java application that produces GUI output 
mare male1|®) 


ORO) 





Unless noted otherwise, all images are © 2014 Cengage Learning 
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CHAPTER 1 Creating Java Programs 


Learning Programming Terminology 


A computer program is a set of instructions that you write to tell a computer what to do. 

Computer equipment, such as a monitor or keyboard, is hardware, and programs are 

software. A program that performs a task for a user (such as calculating and producing 
| 2 paychecks, word processing, or playing a game) is application software; a program that 

manages the computer itself (such as Windows or Linux) is system software. The logic 
behind any computer program, whether it is an application or system program, determines 
the exact order of instructions needed to produce desired results. Much of this book describes 
how to develop the logic to create application software. 





All computer programs ultimately are converted to machine language. Machine language, or 
machine code, is the most basic set of instructions that a computer can execute. Each type of 
processor has its own set of machine language instructions. Programmers often describe 

machine language using 1s and Os to represent the on-and-off circuitry of computer systems. 


Machine language is a low-level programming language, or one that corresponds closely to a 
computer processor's circuitry. Low-level languages require you to use memory addresses for 
specific machines when you create commands. This means that low-level languages are 

difficult to use and must be customized for every type of machine on which a program runs. 


Fortunately, programming has evolved into an easier task because of the development of 
high-level programming languages. A high-level programming language allows you to use a 
vocabulary of reasonable terms, such as read, write, or add, instead of the sequences of 1s and 
Os that perform these tasks. High-level languages also allow you to assign single-word, 
intuitive names to areas of computer memory, such as hoursWorked or rateOfPay, rather 
than having to remember the memory locations. Java is a high-level programming language. 


Each high-level language has its own syntax, or rules of the language. For example, depending on 
the specific high-level language, you might use the verb print or write to produce output. All 
languages have a specific, limited vocabulary (the language’s keywords) and a specific set of rules 
for using that vocabulary. When you are learning a computer programming language, such as Java, 
C++, or Visual Basic, you really are learning the vocabulary and syntax rules for that language. 


Using a programming language, programmers write a series of program statements, similar 
to English sentences, to carry out the tasks they want the program to perform. Program 
statements are also known as commands because they are orders to the computer, such as 
“output this word” or “add these two numbers.” 


After the program statements are written, high-level language programmers use a computer 
program called a compiler or interpreter to translate their language statements into machine 
language. A compiler translates an entire program before carrying out the statement, or 
executing it, whereas an interpreter translates one program statement at a time, executing a 
statement as soon as it is translated. 


example, C++ is a compiled language, and Visual Basic is an interpreted language. Each type of translator 
has its supporters; programs written in compiled languages execute more quickly, whereas programs 
written in interpreted languages are easier to develop and debug. Java uses the best of both technologies: a 
compiler to translate your programming statements and an interpreter to read the compiled code line by line 
when the program executes (also called at run time). 
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Q Whether you use a compiler or interpreter often depends on the programming language you use. For 





Learning Programming Terminology D0 


Compilers and interpreters issue one or more error messages each time they encounter an 
invalid program statement—that is, a statement containing a syntax error, or misuse of the 
language. Subsequently, the programmer can correct the error and attempt another 
translation by compiling or interpreting the program again. Locating and repairing all syntax 
errors is the first part of the process of debugging a program—freeing the program of all 

errors. Figure 1-1 illustrates the steps a programmer takes while developing an executable 3 Zz 
program. You will learn more about debugging Java programs later in this chapter. 












Plan program logic 











Write program language statements 
that correspond to the logic 









Use translating software (a compiler or 
interpreter) that translates programming 
language statements to machine language 





Debugging process 






Can all statements 
be successfully 
translated? 








Examine list of 
syntax errors 


Debugging process 


Execute the program 











Examine 
program output 







Are there runtime 
errors or errors 
in the output? 
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CHAPTER 1 Creating Java Programs 


As Figure 1-1 shows, you might be able to use a computer language’s syntax correctly but still 

have errors to correct. In addition to learning the correct syntax for a particular language, 

a programmer must also understand computer programming logic. When you develop 

a program of any significant size, you should plan its logic before you write any program 

statements. Correct logic requires that all the right commands be issued in the appropriate 
| 4 order. Examples of logical errors include multiplying two values when you meant to divide 
them or producing output prior to obtaining the appropriate input. 





Correcting logical errors is the second part of the debugging process and is much more 
difficult than correcting syntax errors. Syntax errors are discovered when you compile a 
program, but often you can identify logical errors only when you examine a program’s first 
output. For example, if you know an employee’s paycheck should contain the value $5,000, 
but you see that it holds $50 or $50,000 after you execute a payroll program, a logical error 
has occurred. Tools that help you visualize and understand logic are presented in the chapter 
Making Decisions. 


language word, you commit a syntax error, but if you use a correct word in the wrong context, you commit 


Programmers call some logical errors semantic errors. For example, if you misspell a programming- 
GY a semantic error. 


Learning Programming Terminology 


In each “Two Truths & a Lie” section, two of the numbered statements are true, and one 
is false. Identify the false statement and explain why it is false. 


1. Unlike a low-level programming language, a high-level programming language 
allows you to use a vocabulary of reasonable terms instead of the sequences of on 
and off switches that perform the corresponding tasks. 


2. Acompiler executes each program statement as soon as it is translated, whereas 
an interpreter translates all of a program’s statements before executing any. 


3. A syntax error occurs when you misuse a language; locating and repairing all 
syntax errors is part of the process of debugging a program. 


‘paye|sues} SI jl Se UOOS Se JUaWWa}e}s e SUljNDaXa ‘AW e Je 
juawa}ey}s Wess01d au Saj}e|SueJ} Ja}asCajUl Ue SeaJaUM ‘SjualWa}e}s Aue JNO 
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Comparing Procedural and Object-Oriented Programming Concepts D0 


Comparing Procedural and Object-Oriented 
Programming Concepts 


Two popular approaches to writing computer programs are procedural programming and 


object-oriented programming. > iE 
5 


Procedural Programming 


Procedural programming is a style of programming in which operations are executed one 
after another in sequence. In procedural applications, you create names for computer 
memory locations that can hold values—for example, numbers and text—in electronic form. 
The named computer memory locations are called variables because they hold values that 
might vary. For example, a payroll program written for a company might contain a variable 
named rateOfPay. The memory location referenced by the name rateOfPay might contain 
different values (a different value for every employee of the company) at different times. 
During the execution of the payroll program, each value stored under the name rateOfPay 
might have many operations performed on it—the value might be read from an input device, 
the value might be multiplied by another variable representing hours worked, and the 

value might be printed on paper. For convenience, the individual operations used in 

a computer program are often grouped into logical units called procedures. For 

example, a series of four or five comparisons and calculations that together determine 

a person’s federal withholding tax value might be grouped as a procedure named 
calculateFederalWithholding. A procedural program defines the variable memory 
locations and then calls a series of procedures to input, manipulate, and output the values 
stored in those locations. When a program calls a procedure, the current logic is temporarily 
abandoned so that the procedure’s commands can execute. A single procedural program 
often contains hundreds of variables and procedure calls. Procedures are also called modules, 
methods, functions, and subroutines. Users of different programming languages tend to use 
different terms. As you will learn later in this chapter, Java programmers most frequently 
use the term method. 





Object-Oriented Programming 


Object-oriented programming is an extension of procedural programming in which you take 
a slightly different approach to writing computer programs. Writing object-oriented 
programs involves creating classes, which are blueprints for objects; creating objects from 
those classes; and creating applications that use those objects. After creation, classes can be 
reused repeatedly to develop new programs. Thinking in an object-oriented manner involves 
envisioning program components as objects that belong to classes and that are similar to 
concrete objects in the real world; then, you can manipulate the objects and have them 
interrelate with each other to achieve a desired result. 


Programmers use OO as an abbreviation for object-oriented; it is pronounced “oh oh.” Object-oriented 
Y programming is abbreviated OOP, and pronounced to rhyme with soup. 
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CHAPTER 1 Creating Java Programs 


Originally, object-oriented programming was used most frequently for two major types of 
applications: 


e Computer simulations, which attempt to mimic real-world activities so that their 
processes can be improved or so that users can better understand how the real-world 


| 6 processes operate 


e Graphical user interfaces, or GUIs (pronounced “gooeys”), which allow users to interact 
with a program in a graphical environment 





Thinking about objects in these two types of applications makes sense. For example, a city 
might want to develop a program that simulates traffic patterns to help prevent traffic tie-ups. 
By creating a model with objects such as cars and pedestrians that contain their own data and 
rules for behavior, the simulation can be set in motion. For example, each car object has a 
specific current speed and a procedure for changing that speed. By creating a model of city 
traffic using objects, a computer can create a simulation of a real city at rush hour. 


Creating a GUI environment for users also is a natural use for object orientation. It is easy to 
think of the components a user manipulates on a computer screen, such as buttons and scroll 
bars, as similar to real-world objects. Each GUI object contains data—for example, a button 
on a screen has a specific size and color. Each object also contains behaviors—for example, 
each button can be clicked and reacts in a specific way when clicked. Some people consider 
the term object-oriented programming to be synonymous with GUI programming, but object- 
oriented programming means more. Although many GUI programs are object oriented, do 
not assume that all object-oriented programs use GUI objects. Modern businesses use object- 
oriented design techniques when developing all sorts of business applications, whether they 
are GUI applications or not. 


Understanding object-oriented programming requires grasping three basic concepts: 
e Encapsulation as it applies to classes as objects 
e Inheritance 


e Polymorphism 


Understanding Classes, Objects, and Encapsulation 


In object-oriented terminology, a class is a term that describes a group or collection of 
objects with common properties. In the same way that a blueprint exists before any houses 
are built from it, and a recipe exists before any cookies are baked from it, so does a class 
definition exist before any objects are created from it. A class definition describes what 
attributes its objects will have and what those objects will be able to do. Attributes are the 
characteristics that define an object; they are properties of the object. When you learn a 
programming language such as Java, you learn to work with two types of classes: those that have 
already been developed by the language’s creators and your own new, customized classes. 


An object is a specific, concrete instance of a class. When you create an object, you 
instantiate it. You can create objects from classes that you write and from classes written by 
other programmers, including Java’s creators. The values contained in an object’s properties 
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often differentiate instances of the same class from one another. For example, the class 
Automobile describes what Automobile objects are like. Some properties of the Automobile 
class are make, model, year, and color. Each Automobile object possesses the same attributes 
but not, of course, the same values for those attributes. One Automobile might be a 2009 
white Ford Taurus and another might be a 2014 red Chevrolet Camaro. Similarly, your dog 
has the properties of all Dogs, including a breed, name, age, and whether his shots are current. 7 L_ 
The values of the properties of an object are also referred to as the object’s state. In other 

words, you can think of objects as roughly equivalent to nouns, and of their attributes as 

similar to adjectives that describe the nouns. 





When you understand an object’s class, you understand the characteristics of the object. 

If your friend purchases an Automobile, you know it has a model name, and if your friend gets 
a Dog, you know the dog has a breed. Knowing what attributes exist for classes allows you 
to ask appropriate questions about the states or values of those attributes. For example, 
you might ask how many miles the car gets per gallon, but you would not ask whether the 
car has had shots. Similarly, in a GUI operating environment, you expect each component 
to have specific, consistent attributes and methods, such as a window having a title bar and 
a close button, because each component gains these properties as a member of the general 
class of GUI components. Figure 1-2 shows the relationship of some Dog objects to the 

Dog class. 


that defines the attributes and methods of an automobile would probably be named Automobi le, and 
the class for dogs would probably be named Dog. However, following this convention is not required to 
produce a workable program. 


Q By convention, programmers using Java begin their class names with an uppercase letter. Thus, the class 


Dog class definition Dog class instances (objects) 


Every Dog that is 
created will have 
a: 


Name 


Age 

Ginger Bowser Roxy 
Breed 6 2 1 

Akita Retriever Beagle 
Shot status Up to date Up to date Up to date 








Figure 1-2 Aclass definition and some objects created from it 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 1 Creating Java Programs 


Besides defining properties, classes define methods their objects can use. A method is a self- 

contained block of program code that carries out some action, similar to a procedure in a 

procedural program. An Automobile, for example, might have methods for moving forward, 

moving backward, being filled with gasoline, and being washed. Some methods can ascertain 

certain attributes, such as the current speed of an Automobile and the status of its gas tank. 
| 8 Similarly, a Dog can walk or run, eat food, and get a bath, and there are methods to determine 
how hungry the Dog is or what its name is. GUI operating system components can be 
maximized, minimized, and dragged. In other words, if objects are similar to nouns, then 
methods are similar to verbs. 





In object-oriented classes, attributes and methods are encapsulated into objects that are then 
used much like real-world objects. Encapsulation refers to two closely related object-oriented 
notions: 


e Encapsulation is the enclosure of data and methods within an object. Encapsulation allows 
you to treat all of an object’s methods and data as a single entity. Just as an actual dog 
contains all of its attributes and abilities, so would a program’s Dog object. 


e Encapsulation also refers to the concealment of an object’s data and methods from outside 
sources. Concealing data is sometimes called information hiding, and concealing how 
methods work is implementation hiding; you will learn more about both terms in the 
chapter Using Methods, Classes, and Objects. Encapsulation lets you hide specific object 
attributes and methods from outside sources and provides the security that keeps data and 
methods safe from inadvertent changes. 


If an object’s methods are well written, the user is unaware of the low-level details of how the 
methods are executed, and the user must simply understand the interface or interaction 
between the method and the object. For example, if you can fill your Automobile with 
gasoline, it is because you understand the interface between the gas pump nozzle and the 
vehicle’s gas tank opening. You don’t need to understand how the pump works mechanically 
or where the gas tank is located inside your vehicle. If you can read your speedometer, it does 
not matter how the displayed figure is calculated. As a matter of fact, if someone produces a 
superior, more accurate speed-determining device and inserts it in your Automobile, you 
don’t have to know or care how it operates, as long as your interface remains the same. The 
same principles apply to well-constructed classes used in object-oriented programs— 
programs that use classes only need to work with interfaces. 


Understanding Inheritance and Polymorphism 


An important feature of object-oriented program design is inheritance—the ability to create 
classes that share the attributes and methods of existing classes but with more specific 
features. For example, Automobi 1e is a class, and all Automobile objects share many traits and 
abilities. Convertible is a class that inherits from the Automobi1e class; a Convertible is a 
type of Automobile that has and can do everything a “plain” Automobile does—but with an 
added mechanism for and an added ability to lower its top. (In turn, Automobi1e inherits from 
the Vehicle class.) Convertible is not an object—it is a class. A specific Convertible is an 
object—for example, my1967B1ueMustangConvertible. 
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Inheritance helps you understand real-world objects. For example, the first time you 
encounter a Convertible, you already understand how the ignition, brakes, door locks, and 
other Automobile systems work. You need to be concerned only with the attributes and 
methods that are “new” with a Convertible. The advantages in programming are the same— 
you can build new classes based on existing classes and concentrate on the specialized 


features you are adding. 9 L 


A final important concept in object-oriented terminology is polymorphism. Literally, 
polymorphism means “many forms’”—it describes the feature of languages that allows the 
same word or symbol to be interpreted correctly in different situations based on the 
context. For example, although the classes Automobile, Sailboat, and Airplane all inherit 
from Vehicle, turn and stop methods work differently for instances of those classes. 

The advantages of polymorphism will become more apparent when you begin to create 
GUI applications containing features such as windows, buttons, and menu bars. In a GUI 
application, it is convenient to remember one method name, such as setColor or setHeight 
and have it work correctly no matter what type of object you are modifying. 





When you see a plus sign ( + ) between two numbers, you understand they are being 
added. When you see it carved in a tree between two names, you understand that the 
names are linked romantically. Because the symbol has diverse meanings based on context, 
it is polymorphic. Chapters 10 and 11 provide more information about inheritance and 
polymorphism and how they are implemented in Java. 


ee 
eu Watch the video Object-Oriented Programming. 


Comparing Procedural and Object-Oriented 
Programming Concepts 


1. An instance of a class is a created object that possesses the attributes and 
methods described in the class definition. 
Encapsulation protects data by hiding it within an object. 


Polymorphism is the ability to create classes that share the attributes and methods 
of existing classes, but with more specific features. 
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Features of the Java Programming Language 


Java was developed by Sun Microsystems as an object-oriented language for general-purpose 

business applications and for interactive, World Wide Web-based Internet applications. 

Some of the advantages that have made Java so popular in recent years are its security features 
ZZ 10 and the fact that it is architecturally neutral: Unlike other languages, you can use Java to write 

a program that runs on any operating system (such as Windows, Mac OS, or Linux) or device 
(such as PCs, phones, and tablet computers). 





Java can be run on a wide variety of computers and devices because it does not execute 
instructions on a computer directly. Instead, Java runs on a hypothetical computer known as 
the Java Virtual Machine (JVM). When programmers call the JVM hypothetical, they don’t 
mean it doesn’t exist. Instead, they mean it is not a physical entity created from hardware but 
is composed only of software. 


Figure 1-3 shows the Java environment. Programming statements written in a high-level 
programming language are source code. When you write a Java program, you first 
construct the source code using a text editor such as Notepad or a development 
environment and source code editor such as JGRASP, which you can download from the 
Web for free. A development environment is a set of tools that help you write programs 
by providing such features as displaying a language’s keywords in color. The statements are 
saved in a file; then, the Java compiler converts the source code into a binary program 

of bytecode. A program called the Java interpreter then checks the bytecode and 
communicates with the operating system, executing the bytecode instructions line by line 
within the Java Virtual Machine. Because the Java program is isolated from the operating 
system, the Java program also is insulated from the particular hardware on which it is run. 
Because of this insulation, the JVM provides security against intruders accessing your 
computer’s hardware through the operating system. Therefore, Java is more secure 

than other languages. Another advantage provided by the JVM means less work for 
programmers—when using other programming languages, software vendors usually have 
to produce multiple versions of the same product (a Windows version, Macintosh version, 
UNIX version, Linux version, and so on) so all users can run the program. With Java, one 
program version runs on all these platforms. “Write once, run anywhere” (WORA) is a slogan 
developed by Sun Microsystems to describe the ability of one Java program version to work 
correctly on multiple platforms. 
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Java Source Code 


















Source code is 
stored on a disk in 
a file with a name 
ending in .java 





a 










Java Compiler 


Compiler creates 
bytecode that 
is stored ona 

disk in a file with 


; a name ending in 
Java Virtual Machine .class 


Java Interpreter 


JVM (named java.exe) 
performs security checks 
and translates bytecode to 
machine language, which 
executes 


Computer Operating 
System 








Figure 1-3 The Java environment 


Java also is simpler to use than many other object-oriented languages. Java is modeled after 
C++. Although neither language is easy to read or understand on first exposure, Java does 
eliminate some of the most difficult-to-understand features in C++, such as pointers and 
multiple inheritance. 


Java Program Types 
You can write two kinds of programs using Java: 


e Applets are programs that are embedded in a Web page. You will create applets in the 
chapter Applets, Images, and Sound. 


e Java applications are stand-alone programs. Java applications can be further 
subdivided into console applications, which support character output to a computer 
screen in a DOS window, for example, and windowed applications, which create a GUI 
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of 





with elements such as menus, toolbars, and dialog boxes. Console applications are the 
easiest applications to create; you start using them in the next section. 


Features of the Java Programming Language 


1. Java was developed to be architecturally neutral, which means that anyone can 
build an application without extensive study. 


2. After you write a Java program, the compiler converts the source code into a binary 
program of bytecode. 


3. Java programs that are embedded in a Web page are called applets, while 
stand-alone programs are called Java applications. 
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Analyzing a Java Application that Produces 
Console Output 


At first glance, even the simplest Java application involves a fair amount of confusing syntax. 
Consider the application in Figure 1-4. This program is written on seven lines, and its only 
task is to display “First Java application” on the screen. 


public class First 


{ 
public static void main(String[] args) 


{ 
} 


System.out.printInC"First Java application") ; 





Figure 1-4 The First class 


When you see program code in figures in this book, Java keywords as well as true, false, and nul] are 
blue, and all other program elements are black. A complete list of Java keywords is shown later in this 
chapter. 


download so that you can execute the programs on your own computer. 


Q The code for every complete program shown in this book is available in a set of student files you can 
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Understanding the Statement that Produces the Output 


Although the program in Figure 1-4 occupies several lines, it contains only one 

Java programming statement. The statement System.out.printIn("First Java 
application"); does the actual work in this program. Like all Java statements, this one 
ends with a semicolon. Most Java programming statements can be spread across as many 13 [ 
lines as you choose, as long as you place line breaks in appropriate places. For example, 

in the program in Figure 1-4, you could place a line break before or after the opening 

parenthesis, or before or after the closing parenthesis. However, you usually want to place 

a short statement on a single line. 





The text “First Java application” is a literal string of characters—a series of characters that 
will appear in output exactly as entered. Any literal string in Java is written between double 
quotation marks. In Java, a literal string cannot be broken and placed on multiple lines. 
Figure 1-5 labels this string and the other parts of the statement. 





"First Java application" 





out is an object defined in is a literal string that is the argument 
System is a class. the System class. to the printIn() method. 


System.out.printInC"First Java application"); 






Dots separate classes, print]nQ) is a method. Every Java statement ends 


objects, and methods. Method names are always with a semicolon. 
followed by parentheses. 





Figure 1-5 Anatomy of a Java statement 


The string “First Java application” appears within parentheses because the string is 

an argument to a method, and arguments to methods always appear within parentheses. 
Arguments are pieces of information that are sent into a method, usually because the 
method requires the information to perform its task or carry out its purpose. The act of 
sending arguments to a method is called passing arguments to the method. As an example, 
consider placing a catalog order with a company that sells sporting goods. Processing a 
catalog order is a method that consists of a set of standard procedures—recording the 
order, checking the availability of the item, pulling the item from the warehouse, and so on. 
Each catalog order also requires a set of data items, such as which item number you are 
ordering and the quantity of the item desired; these data items can be considered the 
order’s arguments. If you order two of item 5432 from a catalog, you expect different 
results than if you order 1,000 of item 9008. Likewise, if you pass the argument 

“Happy Holidays” to a Java method, you expect different results than if you pass the 
argument “First Java application”. 
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Within the statement System.out.printIn("First Java application") ;, the method to 
which you are passing "First Java application" is named printIn(Q). The Java methods 
printInQ and printQ© both produce output. With printinQ, after the output is displayed, 
the insertion point moves to the following line. (The insertion point is the point at which the 
next output appears.) With printQ, however, the insertion point does not advance to a new 


| 14 line; it remains on the same line as the output. 


When you call a method, you always use parentheses following the method name. In this 
book, you will learn about many methods that require arguments between their parentheses, 
and many others for which you leave the parentheses empty. The printIn© method can be 
used with no arguments when you want to output a blank line. Later in this chapter, you will 
learn about a method named showMessageDialog() that requires two arguments. Other 
methods require more. 





Within the statement System.out.printIn("First Java application");, out is an object 
that is a property of the System class that refers to the standard output device for a system, 
normally the monitor. The out object itself is an instance of the PrintStream class, which 
contains several methods, including printInQ. Technically, you could create the out object 
and write the instructions within the printInQ method yourself, but it would be time 
consuming, and the creators of Java assumed you frequently would want to display output on 
a screen. Therefore, the System and PrintStream classes, the out object, and the printInO 
method were created as a convenience to the programmer. 


Within the statement System.out.printIn("First Java application") ;, System is a class. 
Therefore, System defines attributes for System objects, just as the Dog class defines the 
attributes for Dog objects. One of the System attributes is out. (You can probably guess that 
another attribute is in and that it represents an input device.) 


The dots (periods) in System.out.printIn( are used to separate the names of the 
components in the statement. You will use this format repeatedly in your Java programs. 


Java is case sensitive; the class named System is a completely different class from one named 
system, SYSTEM, or even sYsTeM, and out is a different object from one named Out or OUT. 
You must pay close attention to using correct uppercase and lowercase values when you write 
Java programs. 


So, the statement that displays the string “First Java application” contains a class, an object 
reference, a method call, a method argument, and a statement-ending semicolon, but the 
statement cannot stand alone; it is embedded within a class, as shown in Figure 1-4. 


Understanding the First Class 


Everything that you use within a Java program must be part of a class. When you write 
public class First, you are defining a class named First. You can define a Java class using 
any name or identifier you need, as long as it meets the following requirements: 


e A Java identifier must begin with a letter of the English alphabet, a non-English letter 
(such as a or mt), an underscore, or a dollar sign. A class name cannot begin with a digit. 


e A Java identifier can contain only letters, digits, underscores, or dollar signs. 
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e A Java identifier cannot be a reserved keyword, such as public or class. (See Table 1-1 
for a list of reserved keywords.) 


e A Java identifier cannot be one of the following values: true, false, or nul1. These are not 
keywords (they are primitive values), but they are reserved and cannot be used. 


Q Java is based on Unicode, which is an international system of character representation. The term letter 15 Zz 





indicates English-language letters as well as characters from Arabic, Greek, and other alphabets. You can 
learn more about Unicode in Appendix B. 


abstract continue for new switch 
assert default goto package synchronized 
boolean do if private this 

break double implements protected throw 

byte else import public throws 

case enum instanceof return transient 
catch extends int short try 

char final interface static void 

class finally long strictfp volatile 
const Float native super while 


Table 1-1 Java reserved keywords 


function. Both words are used in other languages and were reserved in case developers of future versions of 
Java wanted to implement them. 


Q Although they are reserved as keywords, const and goto are not used in Java programs, and they have no 
It is a Java standard, although not a requirement, to begin class identifiers with an uppercase 
letter and employ other uppercase letters as needed to improve readability. The style that 
joins words in which each begins with an uppercase letter is called Pascal casing, or 
sometimes upper camel casing. You should follow established conventions for Java so your 
programs will be easy for other programmers to interpret and follow. This book uses 
established Java programming conventions. 


Table 1-2 lists some valid and conventional class names that you could use when writing 
programs in Java. Table 1-3 provides some examples of class names that could be used in Java 
(if you use these class names, the class will compile) but that are unconventional and not 
recommended. Table 1-4 provides some class name examples that are illegal. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce Learning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 





CHAPTER 1 Creating Java Programs 


a 








Class Name Description 

Employee Begins with an uppercase letter 

UnderGradStudent Begins with an uppercase letter, contains no spaces, and emphasizes each 
new word with an initial uppercase letter 

InventoryItem Begins with an uppercase letter, contains no spaces, and emphasizes the 
second word with an initial uppercase letter 

Budget2014 Begins with an uppercase letter and contains no spaces 


1+) (=a ed Some valid class names in Java 


Class Name 


Description 





Undergradstudent 


Inventory_Item 
BUDGET2014 
budget2014 


New words are not indicated with initial uppercase letters, making this 
identifier difficult to read 


Underscore is not commonly used to indicate new words 
Using all uppercase letters for class identifiers is not conventional 


Conventionally, class names do not begin with a lowercase letter 


Table 1-3 Legal but unconventional and nonrecommended class names in Java 


Class Name 


Description 





Inventory Item 
class 
2014Budget 


phone# 


Space character is illegal in an identifier 
class is a reserved word 
Class names cannot begin with a digit 


The number symbol ( # ) is illegal in an identifier 


| 0) (<r Some illegal class names in Java 


In Figure 1-4 (and again in Figure 1-6), the line public class First is the class header; it 
contains the keyword class, which identifies First as a class. The reserved word public is an 
access specifier. An access specifier defines the circumstances under which a class can be 
accessed and the other classes that have the right to use a class. Public access is the most 
liberal type of access; you will learn about public access and other types of access in the 
chapter Using Methods, Classes, and Objects. 
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The keyword class 


public is an access identifies First as 
specifier. a class. 

a. - 17 [_ 
aoe public class First 


header. { 
public static void main(String[] args) 


First is the name of 
the class. 











Everything { 

between the System.out.printIn("First Java application"); 
braces is the } 

class body. 





Figure 1-6 The parts of a typical class 


After the class header, you enclose the contents of a class within curly braces ( { and } ); any 
data items and methods between the curly braces make up the class body. A class body 
can be composed of any number of data items and methods. In Figure 1-4 (and again in 
Figure 1-6), the class First contains only one method within its curly braces. The name of 
the method is main(), and the main() method, like the printIn© method, includes its own 
set of parentheses. The main() method in the First class contains only one statement—the 
statement that uses the printIn() method. The main() method does not contain any other 
methods, but it calls the printInQ method. 


Indent Style 


In general, whitespace is optional in Java. Whitespace is any combination of nonprinting 
characters. You use whitespace to organize your program code and make it easier to read. 
You can insert whitespace between words or lines in your program code by typing spaces, 
tabs, or blank lines because the compiler ignores these extra spaces. However, you cannot use 
whitespace within an identifier or keyword. 


For every opening curly brace ( { ) in a Java program, there must be a corresponding closing 
curly brace (} ), but the placement of the opening and closing curly braces is not important to 
the compiler. For example, the following class executes in exactly the same way as the one 
shown in Figure 1-4. The only difference is the layout of the braces—the line breaks occur in 
different locations. 


public class First{ 
public static void main(String[] args) { 
System.out.printinC("First Java application") ; 
} 
} 


The indent style shown in the preceding example, in which opening braces are not on 
separate lines, is known as the K & R style and is named for Kernighan and Ritchie, who wrote 
the first book on the C programming language. The indent style shown in Figure 1-4 and used 
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throughout this book, in which curly braces are aligned and each occupies its own line, is 

called the Allman style and is named for Eric Allman, a programmer who popularized the 

style. Java programmers use a variety of indent styles, and all can produce workable Java 

programs. When you write your own code, you should develop a consistent style. In school, 

your instructor might have a preferred style, and when you get a job as a Java programmer, 
| 18 your organization most likely will have a preferred style. With many development 
environments, indentations are made for you automatically as you type. 





Most programmers indent a method’s statements a few spaces more than its curly braces. 
Some programmers indent two spaces, some three, and some four. Some programmers use 
the Tab key to create indentations, but others are opposed to this practice because the Tab 
key can indicate different indentation sizes on different systems. Some programmers don’t 
care whether tabs or spaces are used, as long as you don’t mix them in the same program. The 
Java compiler does not care how you indent. Again, the most important rule is to develop a 
consistent style of which your organization approves. 


Understanding the main() Method 


The method header for the main© method is quite complex. Figure 1-7 shows the parts of 
the main() method. 


static means this method works without 
instantiating an object of the class. 


void is the method’s return type. 













publ ic is an access specifier. 


public class Farst 


This line is the i ; < 2 : 
method header. public static void main(String[] args) 


Everything between System.out.printtIn("First? Java appl 


the curly braces is the 
method body. 


String is a class. Any The square brackets mean the args is the identifier of the array of 
arguments to this method argument to this method is an Strings that is the argument to 
must be String objects. array of Strings. Chapters 8 | | this method. 

and 9 provide more information 

about Strings and arrays. 








Figure 1-7 The parts of a typical mainQ© method 
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The meaning and purpose of each of the terms used in the method header will become clearer 
as you complete this textbook; a brief explanation will suffice for now. 


In the method header public static void main(String[] args), the word public is an 
access specifier, just as it is when you use it to define the First class. 


In Java, the reserved keyword static means that a method is accessible and usable even 
though no objects of the class exist. 


The keyword void used in the main(@) method header indicates that the main() method 
does not return any value when it is called. This doesn’t mean that mainQ doesn’t 

produce output—in fact, the method in Figure 1-4 (and in Figure 1-7) does. It only means 
that the main() method does not send any value back to any other method that might use 
it. You will learn more about return values in the chapter Methods, Classes, and Objects. 


The name of the method is main(). Not all classes have amain() method; in fact, many do 
not. All Java applications, however, must include a class containing a public method 
named main(), and most Java applications have additional classes and methods. When 
you execute a Java application, the JVM always executes the main() method first. 


In the method header public static void main(String[] args), the contents between the 
parentheses, String[] args, represent the type of argument that can be passed to the 
main() method, just as the string "First Java application" is an argument passed to 
the printIn© method. String is a Java class that can be used to hold character strings. 
The identifier args is used to hold any String objects that might be sent to the mainO 
method. The main() method could do something with those arguments, such as display 
them, but in Figure 1-4, the main@ method does not actually use the args identifier. 
Nevertheless, you must place an identifier within the main() method’s parentheses. 

The identifier does not need to be named args—it could be any legal Java identifier—but 
the name args is traditional. 


Even though you pass no arguments, the main() method must contain String[] and a legal identifier 


Q You won't pass any arguments to the main() method in this book, but when you run a program, you could. 


(such as args) within its parentheses. When you refer to the String class in the main() method header, 
the square brackets indicate an array of String objects. You will learn more about the String class and 
arrays in Chapters 7, 8, and 9. 


The simple application shown in Figure 1-4 has many pieces to remember. However, for now 
you can use the Java code shown in Figure 1-8 as a shell, in which you replace AnyClassName 
with a class name you choose and the line /******/ with any statements that you want to 
execute. 


ee 
HN Watch the video A Java Program. 





oo 
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public class AnyClassName 


{ 


public static void main(String[] args) 


{ 
} 


[RRRERE / 








Figure 1-8 Shell code 


Saving a Java Class 


When you write a Java class, you must save it using a storage medium such as a disk, DVD, 
or USB device. In Java, if a class is public (that is, if you use the public access specifier 
before the class name), you must save the class in a file with exactly the same name and a 
java extension. For example, the First class must be stored in a file named First.java. The 
class name and filename must match exactly, including the use of uppercase and lowercase 
characters. If the extension is not .java, the Java compiler does not recognize the file as 
containing a Java class. Appendix A contains additional information on saving a Java 
application. 


Analyzing a Java Application that Produces Console Output 


1. Inthe method header public static void main(String[] args), the word 
public is an access specifier. 


2. Inthe method header public static void main(String[] args), the word 
static means that a method is accessible and usable, even though no objects 
of the class exist. 


3. Inthe method header public static void main(String[] args), the word 
void means that the main() method is an empty method. 
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Xv You Do It 


Your First Application 21 [_ 


Now that you understand the basics of an application written in Java, you are ready to 
enter your own Java application into a text editor. It is a tradition among programmers 
that the first program you write in any language produces “Hello, world!” as its output. 
You will create such a program now. You can use any text editor, such as Notepad or 
TextPad, or a development environment, such as jGRASP. 








It is best to use the simplest available text editor when writing Java programs. Multifeatured word- 


hp processing programs save documents as much larger files because of all the built-in features, such 
L as font styles and margin settings, which the Java compiler cannot interpret. 





1. Start any text editor, and then open a new document. 
2. Type the class header as follows: 


public class Hello 


In this example, the class name is Hello. You can use any valid name you 
want for the class. If you choose Hello, you always must refer to the class as 
Hello, and not as hello, because Java is case sensitive. 


3. Press Enter once, type {, press Enter again, and then type }. You will add the 
main() method between these curly braces. Although it is not required, the 
convention used in this book is to place each curly brace on its own line and to 
align opening and closing curly brace pairs with each other. Using this format 
makes your code easier to read. 


4. As shown in the shaded portion of Figure 1-9, add the main@ method header 
between the curly braces, and then type a set of curly braces for mainQ. 





| public class Hello 

|e 

public static void main(String[] args) 
{ 
} 

| } 

L 


Figure 1-9 The main() method shell for the Hel 1o class 


(continues) 
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(continued) 


5. Next, add the statement within the mainQ method that will produce the 
output “Hello, world!”. Use Figure 1-10 as a guide for adding the shaded 


| 22 printIn(® statement to the mainQ® method. 











public class Hello 
{ 
public static void main(String[] args) 
{ 
System.out.printInC"Hello, world!"); 
} 
} 


























Figure 1-10 Complete Hello class 


6. Save the application as Hello.java. The class name and filename must 
match, and you must use the .java extension. 


Compiling a Java Class and Correcting Syntax Errors 


After you write and save an application, two steps must occur before you can view the 
application’s output. 


1. You must compile the class you wrote (called the source code) into bytecode. 


2. You must use the Java interpreter to translate the bytecode into executable statements. 


Compiling a Java Class 


To compile your source code from the command line, your prompt should show the folder or 
directory where your program file is stored. Then, you type javac followed by the name of 
the file that contains the source code. For example, to compile a file named First.java, you 
type the following and then press Enter: 


javac First.java 
There will be one of three outcomes: 


e You receive a message such as 'javac' is not recognized as an internal or external 
command, operable program or batch file. 


e You receive one or more program language error messages. 


e You receive no messages, which means that the application compiled successfully. 
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When compiling, if the source code file is not in the current path, you can type a full path with the filename. 
For example: 
javac c:\java\MyClasses\Chapter.01\First.java 


current directory to a subdirectory named MyClasses, you type cd MyClasses and press Enter. Within 
any directory, you can back up to the root directory by typing cd\ and pressing Enter. 





Q In aDOS environment, you can change directories using the cd command. For example, to change from the 23 [ 


If you receive an error message that the command is not recognized, it might mean one of the 
following: 


e You misspelled the command javac. 

e You misspelled the filename. 

e You are not within the correct subfolder or subdirectory on your command line. 
e Java was not installed properly. (See Appendix A for information on installation.) 


If you receive a programming language error message, there are one or more syntax errors 
in the source code. Recall that a syntax error is a programming error that occurs when you 
introduce typing errors into your program or use the programming language incorrectly. 
For example, if your class name is first (with a lowercase f) in the source code but you saved 
the file as First.jjava (with an uppercase F), you will receive an error message when you 
compile the application. The error message will be similar to class first is public, should 
be declared ina file named first. java because first and First are not the same in a 
case-sensitive language. If this error occurs, you must reopen the text file that contains 

the source code and make the necessary corrections. 


Appendix A contains information on troubleshooting, including how to change filenames in a Windows 
Y environment. 


If you receive no error messages after compiling the code in a file named First.java, the 
application compiled successfully, and a file named First.class is created and saved in the same 
folder as the text file that holds the application code. After a successful compile, you can run 
the class file on any computer that has a Java language interpreter. 


Correcting Syntax Errors 


Frequently, you might make typing errors as you enter Java statements into your text editor. 
When you issue the command to compile the class containing errors, the Java compiler 
produces one or more error messages. The exact error message that appears varies depending 
on the compiler you are using. 


The FirstwithMissingSemicolon class shown in Figure 1-11 contains an error—the 
semicolon is missing from the end of the printInQ statement. (Of course, this class has been 
helpfully named to alert you to the error.) When you compile this class, an error message 
similar to the one shown in Figure 1-12 is displayed. 
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public class FirstWithMissingSemicolon 


{ 


public static void main(String[] args) 


{ The statement-ending 
System.out.printInC"First Java application") semicolon has been 
} omitted. 








Figure 1-11 The FirstWithMissingSemicolon class 





rv 





fay Command Prompt 


C2\Java>javac FirstWithMissingSemicolon. java 
FirstWithMissingSemicolon.java:5: error: ’5;’ expected 
System.out.printin¢"First Java application"> 


1 error 


C=\Java>_ 





Figure 1-12 Error message generated when the Fi rstwi thMissingSemi colon class is compiled 


The first line of the error message in Figure 1-12 displays the name of the file in which the 
error was found (FirstWithMissingSemicolon.java), the line number in which it was found 
(5), and the nature of the error (“;’ expected”). The next line of the error message displays 
the statement that contains the error, including a caret that points to the exact location where 
the error was first discovered. As you will see when you write and compile Java programs, the 
place where an error is discovered is not necessarily where the error was made. Sometimes, 


it takes a little detective work to interpret an error message and determine its cause. 


Finally, the message generated in Figure 1-12 includes a count of the number of errors 
found—in this case, there is just one error. This is a compile-time error, or one in which the 
compiler detects a violation of language syntax rules and is unable to translate the source 
code to machine code. 


When you compile a class, the compiler reports as many errors as it can find so that you can 
fix as many errors as possible. Sometimes, one error in syntax causes multiple error messages 
that normally would not be errors if the first syntax error did not exist, so fixing one error 
might eliminate multiple error messages. Sometimes, when you fix a compile-time error and 
recompile a program, new error messages are generated. That’s because when you fix the 
first error, the compiler can proceed beyond that point and possibly discover new errors. 
Of course, no programmer intends to type a program containing syntax errors, but when you 
do, the compiler finds them all for you. 
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Compiling a Java Class and Correcting Syntax Errors 


1. After you write and save an application, you can compile the bytecode to create 25 Zz 
source code. 





2. When you compile a class, you create a new file with the same name as the original 
file but with a .class extension. 


3. Syntax errors are compile-time errors. 
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ajidwioo ued nod ‘uoneodidde ue ares pue ajuM NOA Jay “T# SI JuaWa}e}s asje} au] 


aN You Do It 


Compiling a Java Class 


You are ready to compile the He11o class that you created in the previous “You Do It” 
section. 


1. If itis not still open on your screen, open the Hello.java file that you saved in 
the previous “You Do It” section. 


2. Goto the commandline prompt for the drive and folder or subdirectory in 
which you saved Hello.java. At the command line, type: 


javac Hello. java 


After a few moments, you should return to the command prompt. If you see error 
messages instead, reread the previous section to discover whether you can deter- 
mine the source of the error. 


lf the error message indicates that the command was not recognized, make sure that 
you spelled the javac command correctly, including using the correct case. Also, 
make sure you are using the correct directory or folder where the Hello.java file is 
stored. 


lf the error message indicates a language error, check your file against Figure 1-10, 
making sure it matches exactly. Fix any errors, and compile the application again. If 
errors persist, read through the next section to see if you can discover the solution. 


(continues) 
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(continued) 
Correcting Syntax Errors 
mo In this section, you examine error messages and gain firsthand experience with syntax 
errors. 





1. If your version of the Hello class did not compile successfully, examine the 
syntax error messages. Now that you know the messages contain line numbers 
and carets to pinpoint mistakes, it might be easier for you to fix problems. After 
you determine the nature of any errors, resave the file and recompile it. 


2. Even if your Hello class compiled successfully, you need to gain experience with 
error messages. Your student files contain a file named HelloErrors.java. 
Find this file and open it in your text editor. If you do not have access to the 
student files that accompany this book, you can type the file yourself, as shown 
in Figure 1-13. 


public class HelloErrors 


{ 


public static void main(String[] args) 
{ 
System.out.printInC"Hello"); 
System.out.printInC"This is a test"); 
} 





Figure 1-13 The HelloErrors class 


3. Save the file as HelloErrors.java in the folder in which you want to work. Then 
compile the class using the following command to confirm that it compiles 
without error: 


javac HelloErrors. java 


4. In the first line of the file, remove the c from class, making the first line read 
public lass HelloErrors. Save the file and compile the program. Error 
messages are generated similar to those shown in Figure 1-14. Even though you 
changed only one keystroke in the file, four error messages appear. The first 
indicates that class, enum, Or interface is expected in line 1. You haven't 
learned about the Java keywords enum or interface yet, but you know that 
you caused the error by altering the word class. The next three errors in lines 3, 
6, and 7 show that the compile is continuing to look for one of the three 
keywords but fails to find them. 


(continues) 
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(continued) 


Fi | 
[8 Command Prompt =o x 


C=:\Java>javac HelloErrors. java 
HelloErrors.java:1: error: class. interface. 7 expected 27 
public lass HelloErrors 


He lloErrors.java:3: error: class. interface. * expected 
public static void main¢Stringl[] args> 
A 











He lloErrors.java:6: error: cla interface, " expected 
System.out.println¢"This a test"); 
A 


HelloErrors.java:?7: error: class. interface. . expected 

















Figure 1-14 Error messages generated when class is misspelled in the Hel loErrors program 


5. Repair the program by reinserting the c in class. Save the file and compile it 
again. The program should compile successfully. When you fix one error, four 
error messages are removed. 


6. Next, remove the word void from the third line of the program. Save the file 
and compile it. Figure 1-15 shows the error message, which indicates that a 
return type is required. The message does not indicate that void is missing 
because Java supports many return types for methods. In this case, however, 
void is the correct return type, so reinsert it into the correct place in the 
program, and then save and recompile the file. 





ia —, 
fx Command Prompt | = jo xX 


C=\Java>javac HelloErrors. java 
He lloErrors.java:3: error: invalid method declaration; return type required 
public static nain<Stringl] args) 








Figure 1-15 Error message generated when void is omitted from the main() method 
header in the Hel loErrors program 


7. Remove the final closing curly brace from the HelloErrors program. Save the 
file and recompile it. Figure 1-16 shows the generated message “reached end 
of file while parsing.” Parsing is the process the compiler uses to divide your 
source code into meaningful portions; the message means that the compiler 
was in the process of analyzing the code when the end of the file was 


(continues) 
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(continued) 


encountered prematurely. If you repair the error by reinserting the closing curly 
brace, saving the file, and recompiling it, you remove the error message. 


| 28 r 
fay Command Prompt =o x | 


C:\Java>javac HelloErrors. java 
HelloErrors.java:?: error: reached end of file while parsing 




















Figure 1-16 Error message generated when the closing curly brace is omitted from the 
HelloErrors program 


8. Continue to introduce errors in the program by misspelling words, omitting 
punctuation, and adding extraneous keystrokes. Remember to save each 
program version before you recompile it; otherwise, you will recompile the 
previous version. When error messages are generated, read them carefully 
and try to understand their meaning in the context of the error you purposely 
caused. Occasionally, even though you inserted an error into the program, no 
error messages will be generated. That does not mean your program is correct. 
It only means that the program contains no syntax errors. A program can be free 
of syntax errors but still not be correct, as you will learn in the next section. 


Running a Java Application and Correcting Logical Errors 


After a program compiles with no syntax errors, you can execute it. However, just because a 
program compiles and executes, that does not mean the program is error free. 


Running a Java Application 
To run the First application in Figure 1-4 from the command line, you type the following: 


java First 





Figure 1-17 shows the application’s output in sf al 
the command window. In this example, you 


can see that the First class is stored in a NC =:\Java>java First 
First Java application 


Command Prompt 


folder named Java on the C drive. After you 
type the java command to execute the 
program, the literal string in the call is output 
to the printIn© method in the program 
("First Java application"). Control then 
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iC =\Java> 
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The procedure to confirm the storage location of your First.java class varies depending on your operating 

GY system. In a Windows operating system, for example, you can open Windows Explorer, locate the icon 
representing the storage device you are using, find the folder in which you have saved the file, and expand 
the folder. You should see the First.java file. 


When you run a Java application using the java command, do not add the .class 2 
extension to the filename. If you type java First, the interpreter looks for a file named 

First.class. lf you type java First.class, the interpreter incorrectly looks for a file 

named First.class.class. 





Modifying a Compiled Java Class 


After viewing the application output, you might decide to modify the class to get a different 
result. For example, you might decide to change the First application’s output from First 
Java application to the following: 


My new and improved 
Java application 


To produce the new output, first you must modify the text file that contains the existing class. 
You need to change the existing literal string, and then add an output statement for another 
text string. Figure 1-18 shows the class that changes the output. 


public class First 


{ 


public static void main(String[] args) 


{ 


System.out.printInC"My new and improved"); 
System.out.printInC"Java application"); 





Figure 1-18 First class containing output modified from the original version 


The changes to the First class include the addition of the statement System.out.printIn 
("My new and improved"); and the removal of the word First from the string in the other 
printInQ© statement. 


If you make changes to the file, as shown in Figure 1-18, and then save the file and execute the 
program by typing java First at the command line, you will not see the new output—you 
will see the old output without the added line. Even though you save a text file that contains 
the modified source code for a class, the class in the already-compiled class file executes. 
After you save the file named First.java, the old compiled version of the class with the same 
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name is still stored on your computer. Before the new source code can execute, you must do 
the following: 


1. Save the file with the changes (using the same filename). 
2. Compile the class with the javac command. (Actually, you are recompiling the class.) 
| ie 3. Interpret the class bytecode and execute the class using the java command. 


Figure 1-19 shows the new output. - 
[a8 Command Prompt Sax =| 








When you recompile a class, the original 


version of the compiled file with the .class C:\Java>java First 
$ " se My new and impr oved 
extension is replaced, and the original Java application 


version no longer exists. When you modify C:\Java> 
a class, you must decide whether you want 
to retain the original version. If you do, you 
must give the new version a new class 

name and a new filename. Figure 1-19 Execution of modified First class 














Once in a while, when you make a change to a Java class and then recompile and execute it, the old version 
still runs. The simplest solution is to delete the .class file and compile again. Programmers call this creating a 
clean build. 





eu Watch the video Compiling and Executing a Program. 


Correcting Logical Errors 


Besides syntax errors, a second kind of error occurs when the syntax of the program is correct 
and the program compiles but produces incorrect results when you execute it. This type 

of error is a logic error, which is often more difficult to find and resolve. For example, 
Figure 1-20 shows the output of the execution of a successfully compiled program named 
FirstBadOutput. If you glance at the output too quickly, you might not notice that Java is 
misspelled. The compiler does not find spelling errors within a literal string; it is legitimate 
to produce any combination of letters as output. 
Other examples of logic errors include 
multiplying two values when you meant 

to add, printing one copy of a report when Command Prompt 

you meant to print five, or forgetting to Bega eiag nace ano aee 
produce a total at the end of a report when First Jav application 

a user has requested one. Errors of this C:\Java>. 

type must be detected by carefully 
examining the program output. It is 
the responsibility of the program author Figure 1-20 Output of FirstBadOutput 
to test programs and find any logic errors. program 














Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce: “4 ight to remove additional content at any time if subsequent rights restrictions require it. 





Adding Comments to a Java Class D0 


You have already learned that syntax errors are compile-time errors. A logic error is a 

type of run-time error—an error not detected until the program asks the computer to do 
something wrong, or even illegal, while executing. Not all run-time errors are the fault of the 
programmer. For example, a computer’s hardware might fail while a program is executing. 


However, good programming practices can help to minimize errors. aE 
31 





into the circuitry of a mainframe computer at Harvard University in 1947. See these Web sites for interesting 
details and pictures: www.jamesshuggins.com/h/tek1/first_computer_bug.htm and www.history.navy.mil/ 
photos/images/h96000/h96566kc. htm. 


Q The process of fixing computer errors has been known as debugging since a large moth was found wedged 


Running a Java Application and Correcting Logical Errors 


1. In Java, if a class is public, you must save the class in a file with exactly the same 
name and a .java extension. 


2. Tocompile a file named MyProgram.java, you type java MyProgram, but to execute 
the program you type java MyProgram. java. 


3. When you compile a program, sometimes one error in syntax causes multiple error 
messages. 
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Adding Comments to a Java Class 


As you can see, even the simplest Java class requires several lines of code and contains 
somewhat perplexing syntax. Large applications that perform many tasks include much more 
code, and as you write larger applications it becomes increasingly difficult to remember why 
you included steps or how you intended to use particular variables. Documenting your 
program code helps you remember why you wrote lines of code the way you did. Program 
comments are nonexecuting statements that you add to a program for the purpose of 
documentation. In other words, comments are designed for people reading the source code 
and not for the computer executing the program. 


Programmers use comments to leave notes for themselves and for others who might read 
their programs in the future. At the very least, your Java class files should include comments 
indicating the author, the date, and the class name or function. The best practice dictates 
that you also include a brief comment to describe the purpose of each method you create 
within a class. 
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As you work through this book, add comments as the first lines of every file. The comments 
should contain the class name and purpose, your name, and the date. Your instructor might 
ask you to include additional comments. 


Comments also can be useful when you are developing an application. If a program is not 
m2 | performing as expected, you can “comment out” various statements and subsequently run the 

program to observe the effect. When you comment out a statement, you turn it into a 
comment so the compiler does not translate it, and the JVM does not execute its command. 
This can help you pinpoint the location of errant statements in malfunctioning programs. 





There are three types of comments in Java: 


e Line comments start with two forward slashes ( // ) and continue to the end of the current 
line. A line comment can appear on a line by itself or at the end (and to the right) of a line 
following executable code. Line comments do not require an ending symbol. 


e Block comments start with a forward slash and an asterisk ( /* ) and end with an asterisk 
and a forward slash ( */ ). A block comment can appear on a line by itself, on a line before 
executable code, or on a line after executable code. Block comments also can extend 
across as many lines as needed. 


e Javadoc comments are a special case of block comments called documentation 
comments because they are used to automatically generate nicely formatted program 
documentation with a program named javadoc. Javadoc comments begin with a forward 
slash and two asterisks ( /** ) and end with an asterisk and a forward slash (*/ ). Appendix E 
teaches you how to create javadoc comments. 


The forward slash ( / ) and the backslash (\) characters often are confused, but they are two distinct 
GY characters. You cannot use them interchangeably. 


The Java Development Kit (JDK) includes the javadoc tool, which you can use when writing programs in Java. 
The tool produces HTML pages that describe classes and their contents. 


Figure 1-21 shows how comments are used in code. In this example, the only statement that 
executes is the System. out.printIn("Hello"); statement; everything else (all the shaded 
parts) is a comment. 


// Demonstrating comments 
/* This shows 
that these comments 
don’t matter */ 


System.out.printInC"Hello"); // This line executes 
// up to where the comment started 
/* Everything but the printinQ 
is a comment */ 





Figure 1-21 A program segment containing several comments 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Adding Comments to a Java Class D0 


You might want to create comments simply for aesthetics. For example, you might want to 
use a comment that is simply a row of dashes or asterisks to use as a visual dividing line 
between parts of a program. 


= 


Adding Comments to a Java Class 





1. Line comments start with two forward slashes ( //) and end with two backslashes 
(\\); they can extend across as many lines as needed. 


2. Block comments start with a forward slash and an asterisk ( /* ) and end with 
an asterisk and a forward slash ( */ ); they can extend across as many lines as 
needed. 


3. Javadoc comments begin with a forward slash and two asterisks (/** ) and 
end with an asterisk and a forward slash ( */); they are used to generate 
documentation with a program named javadoc. 
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<n You Do It 


Adding Comments to a Class 


In this exercise, you add comments to your Hello.java application and save it as a new 
class named He11o2 so that you can retain copies of both the original and modified 
classes. 


1. Open the Hello.java file you created earlier in this chapter. Enter the following 
comments at the top of the file, inserting your name and today’s date where 
indicated. 

// Filename Hello2.java 


// Written by <your name> 
// Written on <today’s date> 


2. Change the class name to Hello2, and then type the following block comment 
after the class header: 


/* This class demonstrates the use of the printInO 
method to print the message Hello, world! */ 
(continues) 
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(continued) 


3. Save the file as Hello2.java. The file must be named Hello2.java because the 
class name is Hello2. 


4. Go to the commandline prompt for the drive and folder or subdirectory in 
which you saved Hello2.java, and type the following command to compile the 
program: 


javac Hello2.java 


5. When the compile is successful, execute your application by typing java Hello2 
at the command line. The comments have no effect on program execution; the 
output should appear on the next line. 


After the application compiles successfully, a file named Hello2.class is created and stored in the 
same folder as the Hello2.java file. If your application compiled without error but you receive an error 
message, such as “Exception in thread ‘main’ java.lang.NoClassDefFoundError,” when you try to 
execute the application, you probably do not have your class path set correctly. See Appendix A 

for details. 





Creating a Java Application that Produces GUI Output 


Besides allowing you to use the System class to produce command window output, Java 
provides built-in classes that produce GUI output. For example, Java contains a class named 
JOptionPane that allows you to produce dialog boxes. A dialog box is a GUI object 
resembling a window in which you can place messages you want to display. Figure 1-22 shows 
a class named FirstDialog. The FirstDialog class contains many elements that are familiar 
to you; only the two shaded lines are new. 


import javax.swing.JOptionPane; 
public class FirstDialog 
{ 
public static void main(String[] args) 


{ 
} 


JOptionPane.showMessageDialog(null, "First Java dialog"); 





Figure 1-22 The FirstDialog class 


a System.exit(0) ; statement or the application would not terminate. You can add this statement to 


In older versions of Java, any application that used a JOptionPane dialog was required to end with 
YD your programs, and they will work correctly, but it is not necessary. 
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Creating a Java Application that Produces GUI! Output D0 


In Figure 1-22, the first shaded line is an import statement. You use an import statement 
when you want to access a built-in Java class that is contained in a group of classes called 
a package. To use the JOptionPane class, you must import the package named 
javax.swing.JOptionPane. Any import statement you use must be placed outside of any 
class you write in a file. You will learn more about import statements in general, and the 

javax.swing packages in particular, as you continue to study Java. 35 L_ 





out.println() method) because the System class is contained in the package java. lang, 
which is automatically imported in every Java program. You could include the statement 

import java. lang; at the top of any file in which you use the System class, but you are not 
required to do so. 


Q You do not need to use an import statement when you use the System class (as with the System. 


The second shaded statement in the FirstDialog class in Figure 1-22 uses the 
showMessageDialog() method that is part of the JOptionPane class. Like the printInQ) 
method that is used for console output, the showMessageDialog() method is followed 
by a set of parentheses. However, whereas the printInQ method requires only one 
argument between its parentheses to produce an output string, the showMessageDialog() 
method requires two arguments. (Whenever a method requires multiple arguments, they 
are separated by commas.) When the first argument to showMessageDialog() is null, 

as it is in the class in Figure 1-22, it means the output message box should be placed 

in the center of the screen. The second argument, after the comma, is the string that 

is displayed. 


Q Earlier in this chapter, you learned that true, false, and nul] are all reserved words that represent 
values. 


You will learn more about dialog boxes, including how to position them in different locations and how to add 
Y more options to them, in Chapter 2. 


When a user executes the FirstDialog Message 
class, the dialog box in Figure 1-23 is 
displayed. The user must click the OK @ i 
button or the Close button to dismiss 
the dialog box. 











Figure 1-23 Output of the FirstDialog 
application 
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Creating a Java Application that Produces GUI Output 





| 36 1. Adialog box is a GUI object resembling a window in which you can place messages 
you want to display. 


2. You use an append statement when you want to access a builtin Java class that is 
contained in a group of classes called a package. 


3. Different methods can require different numbers of arguments. 
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aN You Do It 


Creating a Dialog Box 
Next, you write a Java application that produces output in a dialog box. 


1. Open a new file in your text editor. Type comments similar to the following, 
inserting your own name and today’s date where indicated. 


// Filename HelloDialog. java 
// Written by <your name> 
// Written on <today’s date> 


2. Enter the import statement that allows you to use the JOptionPane Class: 
import javax. swing. JOptionPane; 

3. Enter the HelloDialog class: 
public class Hel loDialog 


{ 
public static void main(String[] args) 
{ 
JOptionPane.showMessageDialog(null, "Hello, world!"); 
} 
} 


(continues) 
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(continued) 


4. Save the file as HelloDialog.java. Compile the class using the following 
command: 


javac HelloDialog. java 





“i 


Message 


If necessary, eliminate any syntax 
errors, resave the file, and recompile. || (| 
Then execute the program using 


the following command: 


java HelloDialog 





Hello, world! 











The output appears as shown Figure 1-24 Output of Hel loDialog 
in Figure 1-24. application 


5. Click OK to dismiss the dialog box. 


Finding Help 


As you write Java programs, you can frequently consult this book as well as other 

Java documentation. A great wealth of helpful material exists at the Java Web site, 
www.oracle.com/technetwork/java/index.html. Of particular value is the Java application 
programming interface, more commonly referred to as the Java API. The Java API is also 
called the Java class library; it contains information about how to use every prewritten Java 
class, including lists of all the methods you can use with the classes. 


Also of interest at the Java Web site are frequently asked questions (FAQs) that provide 
brief answers to many common questions about Java software and products. You can 
also find several versions of the Java Development Kit (JDK) that you can download 
for free. The JDK is an SDK—a software development kit that includes tools used 

by programmers. Versions are available for Windows, Linux, and Solaris operating 
systems. You can search and browse documentation online or you can download the 
documentation file for the JDK and install it on your computer. After it is installed, 
you can search and browse documentation locally. 


A downloadable set of lessons titled “The Java Tutorial” with hundreds of complete working 
examples is available from http://docs.oracle.com/javase/tutorial/. The tutorial is organized 
into trails—groups of lessons on a particular subject. You can start the tutorial at the 
beginning and navigate sequentially to the end, or you can jump from one trail to another. 
As you study each chapter in this book, you are encouraged to make good use of these 
support materials. 
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| 38 Exploring the Java Web Site 


In this section, you explore some of the material at the Java Web site. 





1. Open an Internet browser and navigate to www.oracle.com/technetwork/ 
java/index.html. 


2. Oracle could change the layout of its Web site after this book is published. 
However, you should be able to find and click a link for Java APIs and then 
another for Java SE 7. (If you are using an older version of Java, you can 
select that version instead.) 


3. All the Java classes are listed in a panel labeled All Classes. Scroll until you 
can select the System class. The largest panel on the page should display 
details about the System class. 


4. You can see that the System class contains three fields. You are already 
familiar with the out field, and you can see that it is an object of type 
PrintStream. Click the hypertext for the PrintStream type to be taken to 
a new page with details about that class. 


5. Scroll through the methods of the PrintStream class. Notice that the class 
contains several versions of the print© and printiIn© methods. Find the 
version of the printIn@ method that accepts a String argument. Click the 
link to the method to read details about it, such as that it “prints a String and 
then terminates the line.” 


6. Many parts of the Java documentation won't mean much to you until you study 
data types and methods in more detail in the next few chapters of this book. 
For now, you can explore the Java Web site to get an idea of the wealth of 
classes that have been created for you. 


Don't Do It 


At the end of each chapter, a Don’t Do It list will alert you to common mistakes made by 
beginning programmers. 


e Don't forget that in Java, a public file’s name must match the name of the class it contains. 
For example, if a file is named Program1.java, you can’t simply rename it 
Program1BackUp.java and expect it to compile unless you change the class name within 
the file. 
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Don'tDo tt 








e Don’t confuse the terms parentheses, braces, brackets, curly braces, square brackets, and 
angle brackets. When you are writing a program or performing some other computerized 
task and someone tells you, “Now, type some braces,” you might want to clarify which 
term is meant. Table 1-5 summarizes these punctuation marks. 

: . . 39 L_ 

Punctuation Name Typical use in Java Alternate names 

() Parentheses Follows method names as Parentheses can be 
in printiInO called round brackets, 

but such usage Is 
unusual 

{} Curly braces A pair surrounds a class Curly braces might also 
body, a method body, and be called curly brackets 
a block of code; when you 
learn about arrays in 
Chapter 8, you will find that 
curly braces also surround 
lists of array values 

[] Square brackets A pair signifies an array; Square brackets might 
arrays are covered in be called box brackets or 
Chapter 8 square braces 

<> Angle brackets A pair of angle brackets When angle brackets 
surrounds HTML tags, as appear with nothing 
you will learn in Chapter between them, they are 
17; in Java, a pair also is called a chevron 
used with generic 
arguments in 
parameterized classes 

|) (-W e) Braces and brackets used in Java 


e Don't forget to end a block comment. Every /* must have a corresponding */, even if it 
is several lines later. It’s harder to make a mistake with line comments (those that start 
with // ), but remember that nothing on the line after the // will execute. 


e Don't forget that Java is case sensitive. 


e Don't forget to end every statement with a semicolon, but vot to end class or method 
headers with a semicolon. 


e Don't forget to recompile a program to which you have made changes. It can be very 
frustrating to fix an error, run a program, and not understand why you don’t see evidence 
of your changes. The reason might be that the .class file does not contain your changes 
because you forgot to recompile. 
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e Don't panic when you see a lot of compiler error messages. Often, fixing one will fix 
several. 


e Don't think your program is perfect when all compiler errors are eliminated. Only by 
running the program multiple times and carefully examining the output can you be 
assured that your program is logically correct. 













Key Terms 

A computer program is a set of instructions that you write to tell a computer what to do. 
Hardware is the general term for computer equipment. 

Software is the general term for computer programs. 

Application software performs tasks for users. 

System software manages the computer. 


The logic behind any program involves executing the various statements and procedures in 
the correct order to produce the desired results. 


Machine language is a circuitry-level language that represents a series of on and off switches. 
Machine code is another term for machine language. 


A low-level programming language is written to correspond closely to a computer 
processor’s circuitry. 


A high-level programming language allows you to use an English-like vocabulary to write 
programs. 


Syntax refers to the rules of a language. 
Keywords are the words that are part of a programming language. 


Program statements are similar to English sentences; they carry out the tasks that programs 
perform. 


Commands are program statements. 


A compiler is a program that translates language statements into machine code; it translates 
an entire program at once before any part of the program can execute. 


An interpreter is a program that translates language statements into machine code; it 
translates one statement at a time, allowing a program to execute partially. 


Executing a statement or program means to carry it out. 


At run time is a phrase that describes the period of time during which a program executes. 
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Key Terms 


A syntax error is a programming error that occurs when you introduce typing errors into 
your program or use the programming language incorrectly. A program containing syntax 
errors will not compile. 


Debugging a program is the process that frees it of all errors. 





Semantic errors occur when you use a correct word in the wrong context in program code. 41 L_ 


Procedural programming is a style of programming in which sets of operations are executed 
one after another in sequence. 


Variables are named computer memory locations that hold values that might vary. 
Procedures are sets of operations performed by a computer program. 


To call a procedure is to temporarily abandon the current logic so that the procedure’s 
commands can execute. 


Writing object-oriented programs involves creating classes, creating objects from those 
classes, and creating applications that use those objects. Thinking in an object-oriented 
manner involves envisioning program components as objects that are similar to 
concrete objects in the real world; then, you can manipulate the objects to achieve 

a desired result. 


Computer simulations are programs that attempt to mimic real-world activities so that their 
processes can be improved or so that users can better understand how the real-world 
processes operate. 


Graphical user interfaces, or GUIs (pronounced “gooeys”), allow users to interact with a 
program in a graphical environment. 


A class is a group or collection of objects with common properties. 


A class definition describes what attributes its objects will have and what those objects will be 
able to do. 


Attributes are the characteristics that define an object as part of a class. 
Properties are attributes of a class. 
An object is an instance of a class. 


An instance of a class is an object. 






To instantiate is to create an instance. 

The state of an object is the set of values for its attributes. 

A method is a self-contained block of program code, similar to a procedure. 
Encapsulation refers to the enclosure of data and methods within an object. 


Inheritance is the ability to create classes that share the attributes and methods of existing 
classes but with more specific features. 
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Polymorphism describes the feature of languages that allows the same word to be interpreted 
correctly in different situations based on the context. 


Java was developed by Sun Microsystems as an object-oriented language used both for 
general-purpose business applications and for interactive, World Wide Web-based Internet 


| 42 applications. 


Architecturally neutral describes the feature of Java that allows you to write programs that 
run on any platform (operating system). 





The Java Virtual Machine (JVM) is a hypothetical (software-based) computer on which Java 
runs. 


Source code consists of programming statements written in a high-level programming 
language. 


jJGRASP is a development environment and source code editor. 


A development environment is a set of tools that help you write programs by providing such 
features as displaying a language’s keywords in color. 


Bytecode consists of programming statements that have been compiled into binary format. 


The Java interpreter is a program that checks bytecode and communicates with the 
operating system, executing the bytecode instructions line by line within the Java Virtual 
Machine. 


“Write once, run anywhere” (WORA) is a slogan developed by Sun Microsystems to describe 
the ability of one Java program version to work correctly on multiple platforms. 


Applets are Java programs that are embedded in a Web page. 
Java applications are stand-alone Java programs. 
Console applications support character output to a computer screen in a DOS window. 


Windowed applications create a graphical user interface (GUI) with elements such as menus, 
toolbars, and dialog boxes. 


A literal string is a series of characters that appear exactly as entered. Any literal string in Java 
appears between double quotation marks. 









Arguments are information passed to a method so it can perform its task. 

Passing arguments is the act of sending them to a method. 

The standard output device is normally the monitor. 

An identifier is a name of a program component such as a class, object, or variable. 
Unicode is an international system of character representation. 


Pascal casing is a naming convention in which identifiers start with an uppercase letter and 
use an uppercase letter to start each new word. 
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Key Terms 


Upper camel casing is Pascal casing. 


An access specifier defines the circumstances under which a class can be accessed and the 
other classes that have the right to use a class. 


The class body is the set of data items and methods between the curly braces that follow the 


class header. 43 L_ 


Whitespace is any combination of nonprinting characters, such as spaces, tabs, and carriage 
returns (blank lines). 





The K &R style is the indent style in which the opening brace follows the header on the same 
line; it is named for Kernighan and Ritchie, who wrote the first book on the C programming 
language. 


The Allman style is the indent style in which curly braces are aligned and each occupies its 
own line; it is named for Eric Allman, a programmer who popularized the style. 


The keyword static means that a method is accessible and usable even though no objects of 
the class exist. 


The keyword void, when used in a method header, indicates that the method does not return 
any value when it is called. 


A compile-time error is one in which the compiler detects a violation of language syntax rules 
and is unable to translate the source code to machine code. 


Parsing is the process the compiler uses to divide source code into meaningful portions for 
analysis. 


A clean build is created when you delete all previously compiled versions of a class before 
compiling again. 


A logic error occurs when a program compiles successfully but produces an error during 
execution. 


A run-time error occurs when a program compiles successfully but does not execute. 


Program comments are nonexecuting statements that you add to a Java file for the purpose of 
documentation. 










To comment out a statement is to turn it into a comment so the compiler will not execute its 
command. 


Line comments start with two forward slashes ( // ) and continue to the end of the current 
line. Line comments can appear on a line by themselves or at the end of a line following 
executable code. 


Block comments start with a forward slash and an asterisk ( /* ) and end with an asterisk and 
a forward slash ( */ ). Block comments can appear on a line by themselves, on a line before 

executable code, or on a line after executable code. Block comments also can extend across as 
many lines as needed. 
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Javadoc comments are block comments that generate documentation. They begin with a 
forward slash and two asterisks ( /** ) and end with an asterisk and a forward slash ( */ ). 


Documentation comments are comments that automatically generate nicely formatted 
program documentation. 


| 44 A dialog box is a GUI object resembling a window in which you can place messages you want 
to display. 





An import statement accesses a built-in Java class that is contained in a package. 
A package contains a group of built-in Java classes. 


The Java API is the application programming interface, a collection of information about how 
to use every prewritten Java class. 


FAQs are frequently asked questions. 
The JDK is the Java Development Kit. 


An SDK is a software development kit, or a set of tools useful to programmers. 


Chapter Summary 


e A computer program is a set of instructions that tells a computer what to do. You can 
write a program using a high-level programming language, which has its own syntax, 
or rules of the language. After you write a program, you use a compiler or interpreter 
to translate the language statements into machine code. 


e Writing object-oriented programs involves creating classes, creating objects from those 
classes, and creating applications—stand-alone executable programs that use those 
objects. Object-oriented programming languages support encapsulation, inheritance, and 
polymorphism. 


e A program written in Java is run on a standardized hypothetical computer called the Java 
Virtual Machine (JVM). When your class is compiled into bytecode, an interpreter within 
the JVM subsequently interprets the bytecode and communicates with your operating 
system to produce the program results. 













e Everything within a Java program must be part of a class and contained within 
opening and closing curly braces. Methods within classes hold statements. All Java 
programming statements end with a semicolon. Periods (called dots) are used to separate 
classes, objects, and methods in program code. All Java applications must have a method 
named main(). Most Java applications have additional methods. 


e Tocompile your source code from the command line, type javac followed by the name of 
the file that contains the source code. The compiler might issue syntax error messages 
that you must correct. When you successfully compile your source code, the compiler 
creates a file with a .class extension. 
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Review Questions) 


e Youcan runa compiled .class file on any computer that has a Java language interpreter by 
entering the java command followed by the name of the class file. When you modify 
a class, you must recompile it for the changes to take effect. After a program executes, 
you must examine the output for logical errors. 


e Program comments are nonexecuting statements that you add to a file for the purpose of 
documentation. Java provides you with three types of comments: line comments, block 
comments, and javadoc comments. 


e Java provides you with built-in classes that produce GUI output. For example, 
Java contains a class named JOptionPane that allows you to produce dialog boxes. 


Review Questions 


1. The most basic circuitry-level computer language, which consists of on and 
off switches, is 





a. a high-level language c. Java 
b. machine language d. C++ 


2. Languages that let you use a vocabulary of descriptive terms, such as read, write, or 





add, are known as languages. 
a. high-level c. procedural 
b. machine d. object-oriented 


3. The rules of a programming language constitute its 








a. objects c. format 
b. logic d. syntax 
4. A translates high-level language statements into machine code. 
a. programmer c. compiler 
b. syntax detector d. decipherer 


5. Named computer memory locations are called 





a. compilers c. addresses 
b. variables d. appellations 


6. The individual operations used in a computer program are often grouped into logical 
units called 





a. procedures c. constants 
b. variables d. logistics 


7. Envisioning program components as objects that are similar to concrete objects in 
the real world is the hallmark of 





a. command-line operating systems c. object-oriented programming 
b. procedural programming d. machine languages 
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8. The values of an object’s attributes also are known as its 








a. state c. methods 

b. orientation d. condition 
nm 46 9. An instance of a class is a(n) : 

a. object c. method 

b. procedure d. class 


10. Java is architecturally 





a. specific c. neutral 
b. oriented d. abstract 


11. You must compile classes written in Java into 





a. bytecode c. javadoc statements 
b. source code d. object code 


12. All Java programming statements must end with a 





a. period c. semicolon 
b. comma d. closing parenthesis 


13. Arguments to methods always appear within 








a. parentheses c. single quotation marks 
b. double quotation marks d. curly braces 
14. Ina Java program, you must use to separate classes, objects, and 
methods. 
a. commas c. dots 
b. semicolons d. forward slashes 


15. All Java applications must have a method named 





a. methodQd c. java) 
b. mainQ d. HelloQ 











16. Nonexecuting program statements that provide documentation are 








called 
a. classes c. comments 
b. notes d. commands 
17. Java supports three types of comments: ; , and 
javadoc. 
a. line, block c. constant, variable 
b. string, literal d. single, multiple 
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Exercises 











18. After you write and save a Java application file, you it. 
a. interpret and then compile c. compile and then resave 
b. interpret and then execute d. compile and then interpret 
19. The command to execute a compiled Java application is : 47 iE 
a. run Cc. javac 
b. execute d. java 


20. You save text files containing Java source code using the file 


extension 

a. java c. .txt 

b. .class d. src 
Exercises 


=) Programming Exercises 


1. For each of the following Java identifiers, note whether it is legal or illegal: 


a. budgetApproval g. ssn# 

b. German Shepherd h. 4999 

c. static i. 17 

d. HELLO j. Accounts_Receivable 
e. 212AreaCode k. 32MPG 

f. qhu6TRfg l. rulesOfOrder 


2. Name at least three attributes that might be appropriate for each of the following 
classes: 
a. CruiseShip 
b. InsurancePolicy 
c. StudentAcademicRecord 










3. Name at least three objects that are instances of each of the following classes: 


a. Song 
b. BaseballTeam 
c. Playwright 
4, Name at least three classes to which each of these objects might belong: 
a. myRedSweater 
b. TondonEngland 
c. thursdaysDinner 
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5. 


G 


10. 


11. 


Write, compile, and test a class that displays your full name on the screen. Save the 
class as FullName.java. 


As you work through the programming exercises in this book, you will create many files. To organize them, 
you might want to create a separate folder in which to store the files for each chapter. 


Write, compile, and test a class that displays your full name, e-mail address, and phone 
number on three separate lines on the screen. Save the class as PersonalInfo.java. 


Write, compile, and test a class that displays the following pattern on the screen: 


Save the class as TableAndChairs.java. 


Write, compile, and test a class that displays the word “Java” on the screen. Compose 
each large letter using the appropriate character, as in the following example: 


J 

J AA V V AA 
J A A VY A A 
J J 
JIIJIIIJ 


AAAAAAA VV AAAAAAA 
A A V A A 


Save the class as BigJavaW ord.java. 


Write, compile, and test a class that displays at least four lines of your favorite song. 
Save the class as FavoriteSong.java. 


Write, compile, and test a class that uses the command window to display the 
following statement about comments: 


“Program comments are nonexecuting statements you add to a file for the purpose of 
documentation.” 


Also include the same statement in three different comments in the class; each 
comment should use one of the three different methods of including comments in 
a Java class. Save the class as Comments.java. 


Modify the Comments.java program in Exercise 10 so that the statement about 
comments is displayed in a dialog box. Save the class as CommentsDialog java. 
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12. From 1925 through 1963, Burma Shave advertising signs appeared next to highways 
all across the United States. There were always four or five signs in a row containing 
pieces of a rhyme, followed by a final sign that read “Burma Shave.” For example, one 
set of signs that has been preserved by the Smithsonian Institution reads as follows: 


Shaving brushes 49 Zz 
You'll soon see ‘em 

On a shelf 

In some museum 


Burma Shave 





Find a classic Burma Shave rhyme on the Web. Write, compile, and test a class that 
produces a series of four dialog boxes so that each displays one line of a Burma Shave 
slogan in turn. Save the class as BurmaShave.java. 


*% Debugging Exercises 


1. Each of the following files in the Chapter01 folder in your downloadable student files 
has syntax and/or logic errors. In each case, determine the problem and fix the 
errors. After you correct the errors, save each file using the same filename preceded 
with Fix. For example, DebugOnel.java will become FixDebugOnel java. 


a. DebugOnel.java c. DebugOne3.java 
b. DebugOne2 java d. DebugOne4java 


When you change a filename, remember to change every instance of the class name within the file so that it 
matches the new filename. In Java, the filename and class name must always match. 


Co, Game Zone 


1. In 1952, A. S. Douglas wrote his University of Cambridge Ph.D. dissertation on 
human-computer interaction and created the first graphical computer game—a 
version of Tic-Tac-Toe. The game was programmed on an EDSAC vacuum-tube 
mainframe computer. The first computer game is generally assumed to be “Space- 
war!”, developed in 1962 at MIT; the first commercially available video game was 
“Pong,” introduced by Atari in 1973. In 1980, Atari’s “Asteroids” and “Lunar Lander” 
became the first video games to be registered in the U. S. Copyright Office. 
Throughout the 1980s, players spent hours with games that now seem very simple 
and unglamorous; do you recall playing “Adventure,” “Oregon Trail,” “Where in the 
World Is Carmen Sandiego?,” or “Myst”? 


















Today, commercial computer games are much more complex; they require many 
programmers, graphic artists, and testers to develop them, and large management 
and marketing staffs are needed to promote them. A game might cost many millions 
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of dollars to develop and market, but a successful game might earn hundreds of 
millions of dollars. Obviously, with the brief introduction to programming you 
have had in this chapter, you cannot create a very sophisticated game. However, 
you can get started. 


ms | For games to hold your interest, they almost always include some random, unpre- 

dictable behavior. For example, a game in which you shoot asteroids loses some of 
its fun if the asteroids follow the same, predictable path each time you play the 
game. Therefore, generating random values is a key component in creating most 
interesting computer games. 





Appendix D contains information on generating random numbers. To fully under- 
stand the process, you must learn more about Java classes and methods. However, 
for now, you can copy the following statement to generate and use a dialog box that 
displays a random number between 1 and 10: 


" 


JOptionPane.showMessageDialog(null,"The number is + 
(1 + Cint) Math.random() * 10))); 


Write a Java application that displays two dialog boxes in sequence. The first asks you 
to think of a number between 1 and 10. The second displays a randomly generated 
number; the user can see whether his or her guess was accurate. (In future chapters 
you will improve this game so that the user can enter a guess and the program can 
determine whether the user was correct. If you wish, you also can tell the user how 
far off the guess was, whether the guess was high or low, and provide a specific 
number of repeat attempts.) Save the file as RandomGuess.java. 


Case Problems 





The case problems in this section introduce two fictional businesses. Throughout 
this book, you will create increasingly complex classes for these businesses that use 
the newest concepts you have mastered in each chapter. 


1. Carly’s Catering provides meals for parties and special events. Write a program 
that displays Carly’s motto, which is “Carly’s makes the food that makes it a 
party.” Save the file as CarlysMotto.java. Create a second program that 
displays the motto surrounded by a border composed of asterisks. Save the file 
as CarlysMotto2.java. 












2. Sammy's Seashore Supplies rents beach equipment such as kayaks, canoes, beach 
chairs, and umbrellas to tourists. Write a program that displays Sammy’s motto, 
which is “Sammy’s makes it fun in the sun.” Save the file as SammysMotto.java. 
Create a second program that displays the motto surrounded by a border 
composed of repeated Ss. Save the file as SammysMotto2.java. 
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Using Data 


In this chapter, you will: 


Declare and use constants and variables 


(©) 


Use integer data types 


(©) 


Use the boolean data type 


ORO) 


Use floating-point data types 


Use the char data type 


(©) 


Use the Scanner class to accept keyboard input 


(©) 


Use the JOptionPane class to accept GUI input 


(©) 


Perform arithmetic 


(©) 


Understand type conversion 


(©) 





Unless noted otherwise, all images are © 2014 Cengage Learning 
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CHAPTER 2 Using Data 


Declaring and Using Constants and Variables 


A data item is constant when its value cannot be changed while a program is running. 
For example, when you include the following statement in a Java class, the number 459 is 
a constant: 


| 52 System.out.print1n(459); 


Every time an application containing the constant 459 is executed, the value 459 is displayed. 
Programmers refer to the number 459 as a literal constant because its value is taken literally 
at each use. The number 459 is also a numeric constant as opposed to a character or string 
constant. Additionally, it is an unnamed constant as opposed to a named one, because no 
identifier is associated with it. 





Instead of using constant data, you can set up a data item to be variable. A variable is a named 
memory location that can store a value. A variable can hold only one value at a time, but the 
value it holds can change. For example, if you create a variable named ovenTemperature, it 

might hold 0 when the application starts, later be altered to hold 350, and still later be altered 
to hold 400. 


Whether a data item is variable or constant, in Java it always has a data type. An item’s 
data type describes the type of data that can be stored there, how much memory the item 
occupies, and what types of operations can be performed on the data. Java provides for eight 
primitive types of data. A primitive type is a simple data type. The eight types are described 
in Table 2-1. Later in this chapter, you will learn more specific information about several 
of these data types. 





Keyword Description 

byte Byte-length integer 

short Short integer 

int Integer 

long Long integer 

float Single-precision floating point 
double Double-precision floating point 
char A single character 

boolean A Boolean value (true or false) 


Table 2-1 Java primitive data types 


The eight data types in Table 2-1 are called primitive because they are simple and 
uncomplicated. Primitive types also serve as the building blocks for more complex data types, 
called reference types, which hold memory addresses. The classes you will begin creating in 
Chapter 3 are examples of reference types, as is the Scanner class you will use later in this 
chapter. 
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Declaring Variables 


A variable declaration is a statement that reserves a named memory location and includes 
the following: 


e A data type that identifies the type of data that the variable will store = 
53 





e An identifier that is the variable’s name 


e An optional assignment operator and assigned value, if you want a variable to contain an 
initial value 


e Anending semicolon 


You name variables using the same naming rules as you do for legal class identifiers. Basically, 
variable names must start with a letter and cannot be a reserved keyword. You must declare 
a variable before you can use it. You can declare a variable at any point before you use it, 
but it is common practice to declare variables first in a method and to place executable 
statements after the declarations. Java is a strongly typed language, or one in which each 
variable has a well-defined data type that limits the operations you can perform with it; 
strong typing implies that all variables must be declared before they can be used. 


Variable names conventionally begin with lowercase letters to distinguish them from class 
names. However, as with class names, a program can compile without error even if names are 
constructed unconventionally. Beginning an identifier with a lowercase letter and capitalizing 
subsequent words within the identifier is a style known as camel casing. An identifier such 
as lastName resembles a camel because of the uppercase “hump” in the middle. 


For example, the following declaration creates a variable of type int named myAge and assigns 
it an initial value of 25; 


int myAge = 25; 


This declaration is a complete, executable statement, so it ends with a semicolon. The equal 
sign ( = ) is the assignment operator. Any value to the right of the equal sign is assigned to 
the variable on the left of the equal sign. An assignment made when you declare a variable is 
an initialization; an assignment made later is simply an assignment. Thus, the first statement 
that follows is an initialization, and the second is an assignment: 

int myAge = 25; 

myAge = 42; 


You declare a variable just once, but you might assign new values to it any number 
of times. 


Note that an expression with a literal to the left of the assignment operator (such as 

25 =myAge) is illegal. The assignment operator has right-to-left associativity. Associativity 
refers to the order in which values are used with operators. The associativity of every 
operator is either right-to-left or left-to-right. An identifier that can appear on the left side 
of an assignment operator sometimes is referred to as an lvalue. A numeric constant like 
25 is not an lvalue; it is only an rvalue, or an item that can appear only on the right side 
of an assignment operator. A variable can be used as an lvalue or an rvalue, but a literal 
number can only be an rvalue. 
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When you declare a variable within a method but do not assign a value to it, it is an 
uninitialized variable. For example, the following variable declaration declares a variable of 
type int named myAge, but no value is assigned at the time of creation: 


int myAge; 
| 54 An uninitialized variable contains an unknown value called a garbage value. Java 
protects you from inadvertently using the garbage value that is stored in an uninitialized 
variable. For example, if you attempt to display garbage or use it as part of a 
calculation, you receive an error message stating that the variable might not have been 
initialized. 





will discover that variables declared in a class, but outside any method, are automatically initialized 


When you learn about creating classes in the chapter Using Methods, Classes, and Objects, you 
GY for you. 


You can declare multiple variables of the same type in separate statements. You also can 
declare two (or more) variables of the same type in a single statement by separating the 
variable declarations with a comma, as shown in the following statement: 


int myAge = 25, yourAge = 19; 


By convention, programmers declare most variables in separate statements. You might 
declare multiple variables in the same statement only if they are closely related. Remember 
that even if a statement occupies multiple lines, the statement is not complete until the 
semicolon is reached. 


You can declare as many variables in a statement as you want, as long as the variables are the 
same data type. However, if you want to declare variables of different types, you must use a 
separate statement for each type. 


Declaring Named Constants 


A variable is a named memory location for which the contents can change. If a named 
location’s value should not change during the execution of a program, you can create it to bea 
named constant. A named constant is also known as a symbolic constant. A named constant 
is similar to a variable in that it has a data type, a name, and a value. A named constant differs 
from a variable in several ways: 


e Inits declaration statement, the data type of a named constant is preceded by the keyword 
final. 


e A named constant can be assigned a value only once, and then it can never be changed. 
Usually you initialize a named constant when you declare it; if you do not initialize the 
constant at declaration, it is known as a blank final, and you can assign a value later. You 
can assign a value to a final constant only once, and you must assign a value before the 
constant is used. 


e Although it is not a requirement, named constants conventionally are given identifiers 
using all uppercase letters, using underscores as needed to separate words. 
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For example, each of the following defines a conventionally named constant: 


final int NUMBER_OF_DEPTS = 20; 

final double PI = 3.14159; 

final double TAX_RATE = 0.015; 

final string COMPANY = "ABC Manufacturing"; 


You can use each of these named constants anywhere you can use a variable of the same type, 
except on the left side of an assignment statement after the first value has been assigned. In 
other words, after they receive their initial values, named constants are rvalues. 


A constant always has the same value within a program, so you might wonder why you 
cannot use the actual, literal value. For example, why not use the unnamed constant 20 when 
you need the number of departments in a company rather than going to the trouble of 
creating the NUMBER_OF_DEPTS named constant? There are several good reasons to use the 
named constant rather than the literal one: 


e The number 20 is more easily recognized as the number of departments if it is associated 
with an identifier. Using named constants makes your programs easier to read and 
understand. Some programmers refer to the use of a literal numeric constant, such as 20, 
as using a magic number—a value that does not have immediate, intuitive meaning or a 
number that cannot be explained without additional knowledge. For example, you might 
write a program that uses the value 7 for several purposes, so you might use constants 
such as DAYS_IN_WEEK and NUM_RETAIL_OUTLETS that both hold the value 7 but more 
clearly describe the purpose. Avoiding magic numbers helps provide internal 
documentation for your programs. 


e Ifthe number of departments in your organization changes, you would change the 
value of NUMBER_OF_DEPTS at one location within your program—where the constant is 
defined—rather than searching for every use of 20 to change it to a different number. 
Being able to make the change at one location saves you time and prevents you from 
missing a reference to the number of departments. 


e Even if you are willing to search for every instance of 20 in a program to change it to 
the new department number value, you might inadvertently change the value of 
one instance of 20 that is being used for something else, such as a payroll deduction 
value. 


e Using named constants reduces typographical errors. For example, if you must include 20 
at several places within a program, you might inadvertently type 10 or 200 for one of the 
instances, and the compiler will not recognize the mistake. However, if you use the 
identifier NUMBER_OF_DEPTS, the compiler will ensure that you spell it correctly. 


e When you use a named constant in an expression, it stands out as separate from a 
variable. For example, in the following arithmetic statement, it is easy to see which 
elements are variable and which are constant because the constants have been named 
conventionally: 


double payAmount = hoursWorked * STD_PAY_RATE - 
numDependents * DEDUCTION; 





= 
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Although many programmers use named constants to stand for most of the constant values 
in their programs, many make an exception when using 0 or 1. 


ms The Scope of Variables and Constants 


A data item’s scope is the area in which it is visible to a program and in which you can refer to 
it using its simple identifier. A variable or constant is in scope from the point it is declared 
until the end of the block of code in which the declaration lies. A block of code is the code 
contained between a set of curly braces. So, if you declare a variable or constant within a 
method, it can be used from its declaration until the end of the method unless the method 
contains multiple sets of curly braces. Then, a data item is usable only until the end of the 
block that holds the declaration. 





of curly braces. In the chapter More Object Concepts, you will learn some techniques for using variables that 


In the chapter Using Methods, Classes, and Objects, you will start to create classes that contain multiple sets 
Y are not currently in scope. 


Concatenating Strings to Variables and Constants 


You can display a variable or a constant in a print() or printInQ statement alone or in 
combination with a string. For example, the NumbersPrint1n class shown in Figure 2-1 
declares an integer billingDate, which is initialized to 5. In the first shaded statement, the 
value of billingDate is sent alone to the print() method; in the second shaded statement, 
billingDate is combined with, or concatenated to, a String. In Java, when a numeric 
variable is concatenated to a String using the plus sign, the entire expression becomes a 
String. In Figure 2-1, print© and printInQ method calls are used to display different data 
types, including a String, a number, and a concatenated String. The output of the 
application shown in Figure 2-1 appears in Figure 2-2. 


public class NumbersPrintIn 


{ 
public static void main(String[] args) 
{ 
int billingDate = 5; 
System.out.print("Bills are sent on day "); 


System. out.print(billingDate) ; 

System.out.printIn(" of the month"); 

System.out.printIn("Next bill: October " + 
billingDate) ; 





Figure 2-1 NumbersPrinttIn class 
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P 


[8 Command Prompt o le ls 


C:\Java>java NumbersPrint ln 
Bills are sent on day 5 of the month 
Next bill: October 5 


C:\Java>_ 57 [ 


Figure 2-2 Output of NumbersPrintIn application 














Y> Later in this chapter, you will learn that a plus sign ( + ) between two numeric values indicates an addition 
Y operation. However, when you place a string on one or both sides of a plus sign, concatenation occurs. In 
7 Chapter 1, you learned that polymorphism describes the feature of languages that allows the same word or 
symbol to be interpreted correctly in different situations based on the context. The plus sign is polymorphic in 
that it indicates concatenation when used with strings but addition when used with numbers. 


When you concatenate a String with numbers, the entire expression is a String. Therefore, 
the expression "A" + 3+ 4 results in the String "A34". If your intention is to create the String 
"A7", then you could add parentheses to write "A" + (3 + 4). 


The program in Figure 2-1 uses the command line to display values, but you also can use a 
dialog box. Recall from Chapter 1 that you can use the showMessageDialog() method with 
two arguments: nu11, which indicates the box should appear in the center of the screen, and 
the String to be displayed in the box. Figure 2-3 shows a NumbersDialog class that uses the 
showMessageDialog() method twice to display an integer declared as creditDays and 
initialized to 30. In each shaded statement in the class, the numeric variable is concatenated 
to a String, making the entire second argument a String. In the first shaded statement, 
the concatenated String is an empty String (or null String), created by typing a set of 
quotes with nothing between them. The application produces the two dialog boxes shown in 
Figures 2-4 and 2-5. The first dialog box shows just the value 30; after it is dismissed by 
clicking OK, the second dialog box appears. 





import javax.swing.JOptionPane; 
public class NumbersDialog 


{ 
public static void main(String[] args) 
{ 
int creditDays = 30; 
JOptionPane.showMessageDialog(null, "" + creditDays) ; 
JOptionPane. showMessageDialog 
(null, "Every bill is due in " + creditDays + " days"); 
} 


} 
| 





Figure 2-3 NumbersDialog class 
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Message 


@ 3 








Figure 2-4 First dialog box created by NumbersDialog application 


Message 


i) Every bill is due in 30 days 


Figure 2-5 Second dialog box created by NumbersDialog application 


Pitfall: Forgetting That a Variable Holds One Value at a Time 


Each constant can hold only one value for the duration of its program; each variable can hold 
just one value at a time. Suppose you have two variables, x and y, and x holds 2 and y holds 
10. Suppose further that you want to switch their values so that x holds 10 and y holds 2. You 
cannot simply make an assignment such as x = y because then both variables will hold 10, and 
the 2 will be lost. Similarly, if you make the assignment y = x, then both variables will hold 2, 
and the 10 will be lost. The solution is to declare and use a third variable, as in the following 
sequence of events: 


int x = 2, y = 10, Zz; 


Z =X; 
x= Yy; 
y=2; 


In this example, the third variable, z, is used as a temporary holding spot for one of the 
original values. The variable z is assigned the value of x, so z becomes 2. Then the value of y, 
10, is assigned to x. Finally, the 2 held in z is assigned to y. The extra variable is used because 
as soon as you assign a value to a variable, any value that was previously in the memory 
location is gone. 


ee 
(== )0 Watch the video Declaring Variables and Constants. 
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Declaring and Using Constants and Variables 


1. A variable is a named memory location that you can use to store a value; it can 59 Zz 
hold only one value at a time, but the value it holds can change. 





2. Anitem’s data type determines what legal identifiers can be used to describe 
variables and whether the variables can occupy memory. 


3. A variable declaration is a statement that reserves a named memory location 
and includes a data type, an identifier, an optional assignment operator and 
assigned value, and an ending semicolon. 


“Asowaw Adnd90 sajqeuen 

jje—Asowaw Adnd00 ued Sajqeuen JayujayM aUILLa}ap JOU SaOp adA} ejep ay} pue 
‘Jaluap! jesa] e JO} Sains ay} Jaye JOU S8Op adA} eyep au] “e}ep ay} UO PaWWOLad aq 
ued suoljesado Jo sad} Jeym pue ‘saidno00 wa}! ay} AJoWsawW YONwW MOY ‘paso}s 

aq UBD Jey} eJep Jo adA} aU Saquosap adA} ejep S,Wa}l UY “Z# SI JUaWA}e}s asje} ay] 


an You Do It 


Declaring and Using a Variable 


In this section, you write an application to work with a variable and a constant. 


1. Open anew document in your text editor. Create a class header and an 
opening and closing curly brace for a new class named DataDemo by typing 
the following: 
public class DataDemo 
{ 

} 

2. Between the curly braces, indent a few spaces and type the following mainQ 
method header and its curly braces: 
public static void main(String[] args) 


{ 
} 


(continues) 
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oc 





(continued) 


Between the mainQ method's curly braces, type the following variable 
declaration: 


int aWholeNumber = 315; 


Type the following output statements. The first displays a string that includes 
a space before the closing quotation mark and leaves the insertion point for 
the next output on the same line. The second statement displays the value of 
aWholeNumber and then advances to a new line. 


System.out.print("The number is "); 
System.out.printlnCaWholeNumber) ; 


Save the file as DataDemo.java. 


Up to this point in the book, every print and printinQ statement you have 
seen has used a String as an argument. When you added the last two state- 
ments to the DataDemo Class, you wrote a printIn@ statement that uses an 
int as an argument. As a matter of fact, there are many different versions of 
print© and printInQ@ that use different data types. Go to the Java Web site 
(www.oracle.com/technetwork/java/index.html), select Java APIs, 

and then select Java SE 7. Scroll through the list of All Classes, and select 
PrintStream; you will recall from Chapter 1 that PrintStream is the data type 
for the out object used with the printIn@ method. Scroll down to view the list of 
methods in the Method Summary, and notice the many versions of the printO 
and printin@ methods, including ones that accept a String, an int, a long, 
and so on. In the last two statements you added to this program, one used a 
method version that accepts a String and the other used a method version 
that accepts an int. 


Compile the file from the 
command line by typing 
javac DataDemo.java. If = 
necessary, correct any 


errors, save the file, and then 
j j C:\Java>java DataDemo 
compile again. The number is 31 








f§ Command Pro... 


Execute the application from 
the command line by typing 
java DataDemo. The 
command window output is 
shown in Figure 2-6. Figure 2-6 Output of the DataDemo application 


C:\Java>_ 





(continues) 
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(continued) 
Trying to Use an Uninitialized Variable 


In this section you see what happens when a variable is uninitialized. 3 





1. In the DataDemo class, remove the assignment operator and the initialization 
value of the awholeNumber variable so the declaration becomes: 


int aWholeNumber; 


2. Save the class and recompile it. An error message appears as shown in Figure 2-7. 
Notice that the declaration statement does not generate an error because you 
can declare a variable without initializing it. However, the printInQ statement 
generates the error message because in Java, you cannot display an uninitialized 
variable. 





fi 


fy Command Prompt 






C=\Java>javac DataDemo. java 
MmDataDemo.java:7?: error: variable allholeNumber might not have been initialized 
System.out . print 1n¢aWho leNumber) 5 


1 error 


C=\Java>. 








Figure 2-7 Error message generated when a variable is not initialized 


3. Modify the awholeNumber declaration so that the variable is again initialized to 
315. Compile the class, and execute it again. 


Adding a Named Constant to a Program 


In this section you add a named constant to the DataDemo program. 


1. After the declaration of the awholeNumber variable in the DataDemo class, 
insert a new line in your program and type the following constant declaration: 


final int STATES_IN_US = 50; 


2. Following the last printIn© statement in the existing program, add a new 
statement to display a string and the constant. In this case, you concatenate 
the string and the numeric value, so the printIn© method call uses the 
version that accepts a String argument. 

System.out.printInC'"The number of states is "+ 


STATES_IN_US); 
(continues) 
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(continued) 





3. Save the program, and 
then compile and execute it. 


The output appears in (C:\Java>java DataDemo 
62 Figure 2-8. The number is 315 


The number of states is 56 





C:2\Java> 








Figure 2-8 Output of DataDemo program 
after recent changes 


Learning About Integer Data Types 


In Java, you can use variables of types byte, short, int, and long to store (or hold) integers; 
an integer is a whole number without decimal places. 


The int data type is the most commonly used integer type. A variable of type int can hold 
any whole number value from —2,147,483,648 to +2,147,483,647. When you assign a value to 
an int variable, you do not type any commas or periods; you type only digits and an optional 
plus or minus sign to indicate a positive or negative integer. 


~\ _ The legal integer values are -23! through 231-1. These are the highest and lowest values that you can store 
Vf in four bytes of memory, which is the size of an int variable. 









The types byte, short, and long are all variations of the integer type. The byte and short 
types occupy less memory and can hold only smaller values; the long type occupies more 
memory and can hold larger values. Table 2-2 shows the upper and lower value limits for each 
of these types. In other programming languages, the format and size of primitive data types 
might depend on the platform on which a program is running. In contrast, Java consistently 
specifies the size and format of its primitive data types. 


Type Minimum Value Maximum Value Size in Bytes : 
byte -128 127 1 
short —32,768 32,767 2 
int -2,147,483,648 2,147,483,647 4 
long -9,223,372,036,854,775,808 9,223,372,036,854,775,807 8 


Table 2-2 Limits on integer values by type 


It is important to choose appropriate types for the variables you will use in an application. If you 
attempt to assign a value that is too large for the data type of the variable, the compiler issues an 
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error message, and the application does not execute. If you choose a data type that is larger than 
you need, you waste memory. For example, a personnel application might use a byte variable 
for number of dependents (because a limit of 127 is more than enough), a short for hours 

worked in a month (because 127 isn’t enough), and an int for an annual salary (because even 
though a limit of 32,000 might be large enough for your salary, it isn’t enough for the CEO’s). 





data types. For example, a hospital computer system in Washington, D.C., used the equivalent of a short 
to count days elapsed since January 1, 1900. The system collapsed on the 32,768th day (which was in 
1989), requiring manual operations for a lengthy period. 


63 
Q Some famous glitches have occurred because programmers did not pay attention to the limits of various 3 


If an application uses a literal constant integer, such as 932, the number is an int by default. If 
you need to use a constant higher than 2,147,483,647, you must follow the number with the 
letter L to indicate long. For example, the following statement stores a number that is greater 
than the maximum limit for the int type. 


long mosquitosInTheNorthWoods = 2444555888L; 


You can type either an uppercase or lowercase L after the digits to indicate the long type, but 
the uppercase L is preferred to avoid confusion with the number 1. You don’t need any special 
notation to store a numeric constant in an int, byte, or a short. 


Because integer constants, such as 18, are type int by default, the examples in this book 
almost always declare a variable as type int when the variable’s purpose is to hold a whole 
number. That is, even if the expected value is less than 128, such as hoursWorkedToday, this 
book will declare the variable to be an int. If you are writing an application in which saving 
memory is important, you might choose to declare the same variable as a byte. 


Saving memory is seldom an issue for an application that runs on a PC. However, when you write applications 
GY for small devices with limited memory, like phones, conserving memory becomes more important. 


Learning About Integer Data Types 


1. Avariable of type int can hold any whole number value from approximately 
negative two billion to positive two billion. 


2. When you assign a value to an int variable, you do not type any commas; you type 
only digits and an optional plus or minus sign to indicate a positive or negative integer. 


3. You can use the data types byte or short to hold larger values than can be 
accommodated by an int. 
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You Do It 


_] 64 Working with Integers 
In this section you work more with integer values. 
1. QOpenanew'file in your text editor, and create a shell for an IntegerDemo class 
as follows: 





public class IntegerDemo 
{ 
} 


2. Between the curly braces, indent a few spaces and write the shell for a mainO 
method as follows: 
public static void main(String[] args) 

{ 
} 

3. Within the main© method, create four declarations, one each for the four 
integer data types. 
int anInt = 12; 
byte aByte = 12; 
short aShort = 12; 
long aLong = 12; 

4. Next, add four output statements that describe and display each of the 
values. The spaces are included at the ends of the string literals so that the 
values will be aligned vertically when they are displayed. 
System.out.printInC("The int is "+ anInt); 

System.out.printIn("The byte is " + aByte); 


System.out.printInC"The short is " + aShort) ; 
System.out.printInC("The long is " + aLong); 


5. Save the file as IntegerDemo.java. Then compile and execute it. Figure 2-9 
shows the output. All the values are legal sizes for each data type, so the 
program compiles and executes without error. 


(continues) 
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(continued) 





r 


fy Command Prompt 


C:\Java>javac IntegerDemo. java 65 [_ 


C:\Java>java IntegerDemo 
int is 2 
byte is 12 
short is 12 
i 4 














Figure 2-9 Output of the IntegerDemo program 


6. Change each assigned value in the application from 12 to 1234, and then 
save and recompile the program. Figure 2-10 shows the error message gener- 
ated because 1234 is too large to be placed in a byte variable. The message, 
“possible loss of precision”, means that if the large number had been 
inserted into the small space, the accuracy of the number would have been 
compromised. 





G 
Command Prompt Sox 


C:\Java>javac IntegerDemo. java 
IntegerDemo.java:6: error: possible loss of precision 
byte aByte = 1234; 
required: byte 
found: int 
error 


=\Java> 














Figure 2-10 Error message generated when a value that is too large is assigned to a 
byte variable 


7. Change the value of aByte back to 12. Change the value of aShort to 
123456. Save and recompile the program. Figure 2-11 shows the result. 
The error message “possible loss of precision” is the same as when the byte 
value was invalid, but the error indicates that the problem is now with the 
short Variable. 


(continues) 
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(continued) 





fa 








Cz\Java>javac IntegerDemo. java 
IntegerDemo.java:?: error: possible loss of precision 


required: short 
found: int 
1 error 


=\Java>_ 


Command Prompt = 


short aShort = 123456; 








Figure 2-11 Error message generated when a value that is too large is assigned to a 
short variable 


8. 


10. 


Change the value of the short variable to 12345, and then save and compile 
the program. Now, the program compiles without error. Execute the program 
and confirm that it runs as expected. 


At the Java Web site (www.oracle.com/technetwork/java/index.html), examine 
the list of printin@ methods in the PrintStream class. Although you can find 
versions that accept String, int, and long arguments, you cannot find ones 
that accept byte or short values. Yet, the println© statements in the latest 
version of the program work correctly. The reason has to do with type 
conversion, which you will learn about later in this chapter. 


Replace the value of aLong with 1234567890987654321. Save the program 
and compile it. Figure 2-12 shows the error message that indicates that the 
integer number is too large. The message does not say that the value is too big 
for a long type variable. Instead, it means that the literal constant was evaluated 
and found to be too large to be a default int before any attempt was made to 
store it in the long variable. 








r — 
f=§ Command Prompt Sx") 


iG: \dava>javac IntegerDemo. - Java 
IntegerDemo.java:8: error: integer number too large: 123456789698 7654321 
long aLong = 123456 7890987654321 5 











Figure 2-12 Error message generated when a value that is too large is assigned to a 
long variable 


(continues) 
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Using the boolean Data Type 


(continued) 


11. Remedy the problem by adding an L to the end of the Jong numeric value. Now, 
the constant is the correct data type that can be assigned to the long variable. 
Save, compile, and execute the program; it executes successfully. 67 [_ 


12. Watch out for errors that occur when data values are acceptable for a data type 
when used alone but together might produce arithmetic results that are out of 
range. To demonstrate, add the following declaration at the end of the current 
list of variable declarations in the IntegerDemo program: 


int anotherInt = anInt * 10000000; 





13. Atthe end of the current list of output statements, add another output statement 
so that you can see the result of the arithmetic: 


System.out.printinC"Another int is " + anotherInt) ; 


Save, compile, and execute the program. The output appears in Figure 2-13. 
Although 1234 and 10000000 are both acceptable int values, their product is 
out of range for an int, and the resulting int does not appear to have been 
calculated correctly. Because the arithmetic result was too large, some informa- 
tion about the value has been lost, including the result’s sign. If you see such 
unreasonable results in your programs, you need to consider using different 
data types for your values. 





G 


f§ Command Prompt |e 


CG: \dava>java IntegerDemo 
1234 
12 
12345 
123456789698 7654321 
* int is —544961888 














Figure 2-13 Output of the modified IntegerDemo program with an out-of-range integer 


Using the boolean Data Type 


Boolean logic is based on true-or-false comparisons. Whereas an int variable can hold 
millions of different values (at different times), a boolean variable can hold only one of two 
values—true or false. The following statements declare and assign appropriate values to 
Boolean variables: 


boolean isItPayday = false; 
boolean areYouBroke = true; 
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You also can assign values based on the result of comparisons to Boolean variables. Java 
supports six relational operators that are used to make comparisons. A relational operator 
compares two items; it is sometimes called a comparison operator. An expression that 
contains a relational operator has a Boolean value. Table 2-3 describes the relational 
operators. 


oo 





because the data type is named for Sir George Boole, the founder of symbolic logic, who lived from 1815 to 


When you use Boolean as an adjective, as in Boolean operators, you usually begin with an uppercase B 
GY 1864. The Java data type boolean, however, begins with a lowercase b. 





Operator Description True Example False Example 
< Less than 3<8 8<3 

> Greater than 4>2 2>4 

== Equal to 7 == 3 == 

<= Less than or equal to 5<=5 8 <=6 

>= Greater than or equal to 7 >=3 1l>=2 

l= Not equal to 5!=6 3!=3 


Table 2-3 Relational operators 


When you use any of the operators that have two symbols ( ==, <=, >=, or != ), you cannot 
place any whitespace between the two symbols. You also cannot reverse the order of the 
symbols. That is, =<, =>, and =! are all invalid operators. 


Legal declaration statements might include the following statements, which compare two 
values directly: 
boolean isSixBigger = (6 > 5); 

// Nalue stored would be true 


boolean isSevenSmallerOrEqual = (7 <= 4); 
// Value stored would be false 


Although you can use any legal identifier for Boolean variables, they are easily identified as Boolean if you use 
GY a form of to be (such as is or are) as part of the variable name, as in isSixBigger. 


The Boolean expressions are more meaningful when variables (that have been assigned 
values) are used in the comparisons, as in the following examples. In the first statement, 
the hours variable is compared to a constant value of 40. If the hours variable is not 
greater than 40, the expression evaluates to false. In the second statement, the income 
variable must be greater than 100000 for the expression to evaluate to true. In the 
third statement, two variables are compared to determine the value of 
isFirstScoreHigher. 
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boolean isOvertimePay = (hours > 40); 
boolean isTaxBracketHigh = (income > 100000); 
boolean isFirstScoreHigher = (scorel > score2); 


Boolean expressions will become far more useful to you when you learn about decision 
making and looping in Chapters 5 and 6. 





oo 


Using the boolean Data Type 


1. A Boolean variable can hold only one of two values—true or false. 


2. Java supports six relational operators that are used to make comparisons: 
=, <, >, =<, =>, and =!. 


3. An expression that contains a relational operator has a Boolean value. 
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Learning About Floating-Point Data Types 


A floating-point number contains decimal positions. Java supports two floating-point data 
types: float and double. A float data type can hold floating-point values of up to six or 
seven significant digits of accuracy. A double data type requires more memory than a float 
and can hold 14 or 15 significant digits of accuracy. The term significant digits refers to 
the mathematical accuracy of a value. For example, a float given the value 0.324616777 is 
displayed as 0.324617 because the value is accurate only to the sixth decimal position. Table 2-4 
shows the minimum and maximum values for each floating-point data type. Notice that the 
maximum value for a double is 3.4 * 10 to the 38" power, which means 3.4 times 10 with 38 
trailing zeros—a very large number. 


times 10 to the 8th power, or 324617000. The e in the displayed value stands for exponent; the +008 
means the true decimal point is eight positions to the right of where it is displayed, indicating a very large 
number. (A negative number would indicate that the true decimal point belongs to the left, indicating a very 
small number.) This format is called scientific notation. The large value contains only six significant digits. 


Q A float given the value 324616777 is displayed as 3.2461 7e+008, which means approximately 3.24617 


if high levels of accuracy are needed, such as in graphics-intensive software, the programmer might choose 


A programmer might choose to store a value as a f1 oat instead of a double to save memory. However, 
Y to use a double, opting for high accuracy over saved memory. 
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Type Minimum Maximum Size in Bytes 
float 34°10" 3.4* 10° 4 
double a7 10" Le 1 8 


| 70 Table 2-4 Limits on floating-point values 





Avalue stored in a doub1e is a double-precision floating-point number; a value in a F 1 oat is a single- 
Y precision floating-point number. 


Just as an integer constant, such as 18, is a value of type int by default, a floating-point 
constant, such as 18.23, is a double by default. To indicate that a floating-point numeric 
constant is a float, you can type the letter F after the number, as in the following: 


float pocketChange = 4.87F; 
You can type either a lowercase or an uppercase F. You also can type D (or d) after a floating- 
point constant to indicate it is a double, but even without the D, the value will be stored as a 


double by default. Floating-point numbers can be imprecise, as you will see later in this 
chapter. 


Learning About Floating-Point Data Types 


1. Java supports two floating-point data types: float and double. The double data 
type requires more memory and can hold more significant digits. 


A floating-point constant, such as 5.6, is a float by default. 


As with integers, you can perform the mathematical operations of addition, 
subtraction, multiplication, and division with floating-point numbers. 
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Using the char Data Type 


You use the char data type to hold any single character. You place constant character values 
within single quotation marks because the computer stores characters and integers 
differently. For example, the following are typical character declarations: 

char middleInitial = 'M'; 


char gradeInChemistry = 'A'; 
char aStar = '*'; 
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character. Others prefer to pronounce the word as char to rhyme with car. You should use the preferred 


Some programmers prefer to pronounce char as care because it represents the first syllable in the word 
Y pronunciation in your organization. 


A character can be any letter—uppercase or lowercase. It might also be a punctuation mark 





or digit. A character that is a digit is represented in computer memory differently than a 71 [ 
numeric value represented by the same digit. For example, the following two statements 
are legal: 


char aCharValue = '9'; 

int aNumValue = 9; 

If you display each of these values using a printIn(Q) statement, you see a 9. However, only 
the numeric value, aNumValue, can be used to represent the value 9 in arithmetic statements. 


A numeric constant can be stored in a character variable and a character that represents a 
number can be stored in a numeric variable. For example, the following two statements are 
legal, but unless you understand their meanings, they might produce undesirable results: 


char aCharValue = 9; 
int aNumValue = '9'; 


If these variables are displayed using printIn© statements, then the resulting output is a 
blank for aCharValue and the number 57 for aNumValue. The unexpected values are Unicode 
values. Every computer stores every character it uses as a number; every character is assigned 
a unique numeric code using Unicode. Table 2-5 shows some Unicode decimal values and 
their character equivalents. For example, the character A is stored using the value 65, and the 
character B is stored using the value 66. Appendix B contains more information on Unicode. 





Dec Char Dec Char Dec Char Dec Char 
0 nul 32 64 @ 96 . 
1 soh*A 33 | 65 A 97 a 
2 stx4B 34 ' 66 B 98 b 
3 etxC 35 # 67 C 99 C 
4 eot4D 36 $ 68 D 100 d 
a) enghE 37 % 69 E 101 e 
6 askAF 38 & 70 F 102 f 
7 belAG 39 : 71 G 103 g 
8 bs4H 40 ( 72 H 104 h 
9 ht 4l ) 73 | 105 
10 IfAJ 42 7 74 J 106 j 





Table 2-5 Unicode values O through 127 and their character equivalents (continues) 
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(continued) 
Dec Char Dec Char Dec Char Dec Char 
11 vt*K 43 + 75 K 107 k 
12 ffAL 44 : 76 L 108 | 
| fe 13 cr*M 45 - 77 M 109 m 
14 so4AN 46 : 78 N 110 n 
15 si40 47 / 79 0 111 fe) 
16 dle*P 48 0 80 P 112 p 
17 dc14Q 49 1 81 Q 113 q 
18 dc24R 50 2 82 R 114 r 
19 dc34S 51 3 83 S 115 S 
20 dc44T 52 4 84 T 116 t 
21 nak4U 53 5 85 U 117 U 
22 syn4V 54 6 86 V 118 Vv 
23 etb*W 55 7 87 Ww 119 w 
24 can’X 56 8 88 X 120 x 
25 emAY 57 9 89 Y 121 y 
26 sub*Z 58 : 90 Z 122 z 
27 esc 59 ; 91 [ 123 { 
28 fs 60 < 92 \ 124 | 
29 gs 61 = 93 ] 125 } 
30 rs 62 > 94 . 126 ~ 
31 us 63 ? 95 127 del 


K-10) (<i) Unicode values O through 127 and their character equivalents 


A variable of type char can hold only one character. To store a string of characters, such as a 
person’s name, you must use a data structure called a String. In Java, String is a built-in 
class that provides you with the means for storing and manipulating character strings. Unlike 
single characters, which use single quotation marks, string constants are written between 
double quotation marks. For example, the expression that stores the name Audrey as a string 
in a variable named firstName is: 


String firstName = "Audrey"; 


You will learn more about strings and the String class in the chapter Characters, Strings, and 
the StringBuilder. 
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You can store any character—including nonprinting characters such as a backspace or a tab— 
in a char variable. To store these characters, you can use an escape sequence, which always 
begins with a backslash followed by a character—the pair represents a single character. For 
example, the following code stores a newline character and a tab character in the char 


variables aNewLine and aTabChar: 
char aNewLine "\n'; 73 [_ 


char aTabChar = '\t'; 





In the declarations of aNewLine and aTabChar, the backslash and character pair acts as a 
single character; the escape sequence serves to give a new meaning to the character. That is, 
the literal characters in the preceding code have different values from the “plain” characters 
"n' or 't'. Table 2-6 describes some common escape sequences that you can use with 
command window output in Java. 





Escape Sequence Description 

\b Backspace; moves the cursor one space to the left 

\t Tab; moves the cursor to the next tab stop 

\n Newline or linefeed; moves the cursor to the beginning of the next line 
\ Carriage return; moves the cursor to the beginning of the current line 
\ Double quotation mark; displays a double quotation mark 

\ Single quotation mark; displays a single quotation mark 

\ Backslash; displays a backslash character 


W-1 0) (<<) Common escape sequences 


sequences '\n" (newline), '\"' (double quote), and '\\' (backslash) operate as expected within a 
JOptionPane object, but '\t', "\b", and '\r' do not work in the GUI environment. 


Q When you display values within JOptionPane dialog boxes rather than in a command window, the escape 
When you want to produce console output on multiple lines in the command window, 
you have two options: You can use the newline escape sequence, or you can use the 
printIn() method multiple times. For example, Figures 2-14 and 2-15 both show 
classes that produce the same output: “Hello” on one line and “there” on another. The 
version you choose to use is up to you. The example in Figure 2-14 is more efficient— 
from a typist’s point of view because the text System.out.printIn appears only once, 
and from the compiler’s point of view because the printIn() method is called only 
once. The example in Figure 2-15, however, might be easier to read and understand. 
When programming in Java, you will find occasions when each of these approaches 
makes sense. 
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public class HelloThereNewLine 


{ 


public static void main(String[] args) 


{ 
} 


System.out.printInC"Hello\nthere") ; 








Figure 2-14 HelloThereNewLine class 


public class HelloTherePrintInTwice 
{ 
public static void main(String[] args) 


{ 


System.out.printInC"Hello"); 
System.out.printInC"there") ; 





Figure 2-15 HelloTherePrintInTwice class 


The println() method uses the local platform’s line terminator character, which might or might not be 
GY the newline character \n. 


Using the char Data Type 
1. You use the char data type to hold any single character; you place constant 
character values within single quotation marks. 


2. To store a string of characters, you use a data structure called a Text; string 
constants are written between parentheses. 


3. An escape sequence always begins with a backslash followed by a character; the 
pair represents a single character. 


“Sse UOILJOND UsaMJaq UdTUM aJe $]UL]SUOD BULIS ‘buLs3s e payed 
aunjonais eyep e asn NOK ‘suajaeseYd JO Buus e B1O]S O| *Z# SI JUaWAles asje} aU] 
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\ You Do It 


Working with the char Data Type 5 [_ 


In the steps in this section, you create an application that demonstrates some 
features of the char data type. 





1. Create the shells for a class named CharDemo and its main() method as follows: 


public class CharDemo 


{ 


public static void main(String[] args) 
{ 
} 
} 
2. Between the curly braces for the main() method, declare a char variable, and 
provide an initialization value: 


char initial = 'A'; 

3. Add two statements. The first displays the variable, and the second 
demonstrates some escape sequence characters. 
System.out.printInCinitial) ; 
System.out.print("\t\"abc\\def\bghi\n\njk1"); 

4. Save the file as CharDemo.java, - 
and then compile and execute it. fa Command Prompt 
Figure 2-16 shows the output. 





C:\Java>java CharDemo 


The first line of output contains A i 
the value of the char variable. ape yeaah 
The next line starts with a tab Jjk1 


C:\Java>_ 


created by the escape sequence 
\t. The tab is followed by a 
quotation mark produced by 

the escape sequence \". Then 
abc is displayed, followed by the 
next escape sequence that 
produces a slash. The next series of characters to display is def, but because 
those letters are followed by a backspace escape sequence, the f is overridden 
by ghi. After ghi, two newline escape sequences provide a double-spaced effect. 
Finally, the last three characters jk1 are displayed. 








Figure 2-16 Output of the CharDemo program 


5. Modify, recompile, and execute the CharDemo program as many times as you like 
until you can accurately predict what will be displayed when you use various 
combinations of characters and escape sequences. 
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CHAPTER 2 Using Data 


Using the Scanner Class to Accept Keyboard Input 


Although you can assign values to variables you declare, programs typically become more 

useful when a user can supply different values for variables each time a program executes. In 

Chapter 1, you learned how to display output on the monitor using the System. out property. 
ZZ 76 System.out refers to the standard output device, which usually is the monitor. To create 

interactive programs that accept input from a user, you can use System.in, which refers to 
the standard input device (normally the keyboard). 





You have learned that you can use the printQ and printInQ@ methods to display many data 
types; for example, you can use them to display a double, int, or String. The System.in 
object is not as flexible; it is designed to read only bytes. That’s a problem, because you often 
want to accept data of other types. Fortunately, the designers of Java have created a class 
named Scanner that makes System.in more flexible. 


To create a Scanner object and connect it to the System. in object, you write a statement 
similar to the following: 


Scanner inputDevice = new Scanner (System. in); 


The portion of the statement to the left of the assignment operator, Scanner 
inputDevice, declares an object of type Scanner with the programmer-chosen name 
inputDevice, in exactly the same way that int x; declares an integer with the 
programmer-chosen name x. 


The portion of the statement to the right of the assignment operator, new Scanner (System. in), 
creates a Scanner object that is connected to the System. in property. In other words, the 
created Scanner object is connected to the default input device. The keyword new is required 
by Java; you will use it whenever you create objects that are more complex than the simple 
data types. 


In the chapter More Object Concepts, you will learn that the second part of the Scanner declaration calls a 
special method called a constructor that is part of the prewritten Scanner class. You also will learn more 
about the Java keyword new in the next two chapters. 
The assignment operator in the Scanner declaration statement assigns the value of the new 
object—that is, its memory address—to the inputDevice object in the program. 


The Scanner class contains methods that retrieve values from an input device. Each 
retrieved value is a token, which is a set of characters that is separated from the next set 
by whitespace. Most often, this means that data is accepted when a user presses the 
Enter key, but it could also mean that a token is accepted after a space or tab. Table 2-7 
summarizes some of the most useful methods that read different data types from the 
default input device. Each retrieves a value from the keyboard and returns it if the next 
token is the correct data type. 
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Method Description 





nextDouble() Retrieves input as a double 

nextIntQ Retrieves input as an int 

nextLine() Retrieves the next line of data and returns it as a String 

next(Q) Retrieves the next complete token as a String 

nextShortQ Retrieves input as a short 

nextByte() Retrieves input as a byte 

nextFloat() Retrieves input as a float. Note that when you enter an input value that will 


be stored as a Float, you do not type an F. The Fis used only with constants 
coded within a program. 


nextLong() Retrieves input as a long. Note that when you enter an input value that will be 
stored as a long, you do not type an L. The L is used only with constants 
coded within a program. 


Table 2-7 Selected Scanner class methods 


the keyboard, you can use the nextLine() method and then use the charAt() method. The 
chapter Characters, Strings, and the StringBuilder provides more details about the charAt() 
method. 


Q The Scanner class does not contain a nextChar() method. To retrieve a single character from 


Figure 2-17 contains a program that uses two of the Scanner class methods. The program 
reads a string and an integer from the keyboard and displays them. The Scanner class is used 
in the four shaded statements in the figure. 


e The first shaded statement is import java.util.Scanner;. This statement imports the 
package necessary to use the Scanner class. 


e The second shaded statement declares a Scanner object named inputDevice. 


e The third shaded statement uses the nextLineQ method to retrieve a line of text from the 
keyboard and store it in the name variable. 


e The last shaded statement uses the nextInt() method to retrieve an integer from the 
keyboard and store it in the age variable. 


Figure 2-18 shows a typical execution of the program. 


the value of the method is the appropriate value, and that you can assign the returned value to a variable, 
display it, or use it in other legal statements. In the chapter Using Methods, Classes, and Objects, you will 
learn how to write your own methods that return values. 


Q Java programmers would say that the Scanner methods return the appropriate value. That also means that 





7H 
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import java.util .Scanner; | 
public class GetUserInfo 
{ 
public static void main(String[] args) 
t String name; Repeating as output what a user 
78 int age; , has entered as input is called 
Scanner inputDevice = new Scanner(System.in); echoing the input. Echoing 
System.out.print("Please enter your name >> "); input is a good programming 
name = inputDevice.nextLine() ; practice; it helps eliminate 
System.out.print("Please enter your age >> "); misunderstandings when the 
age = inputDevice.nextInt(); user can visually confirm 
System.out.printInC"Your name is " + name + what was entered. 
"and you are " + age + " years old."); 
} 


P | 


Figure 2-17 The GetUserInfo class 


C:\Java>java GetUserInfo 

Please enter your name >> Henry 

Please enter your age >> 1? 

Your name is Henry and you are 1? years old. 








C:\Java> 











Figure 2-18 Typical execution of the GetUserInfo program 


If you use any of the Scanner methods and the next token cannot be converted to the right 
data type, you receive an error message. For example, the program in Figure 2-17 uses 
nextInt() to retrieve age, so if the user entered a noninteger value for age, such as the 
double 19.5 or the String "nineteen", an error would occur. You will learn how to recover 
from this type of error in the chapter Exception Handling, but for now, you will have to trust 
the user to enter the correct data type. 


The literal Strings contained in the print() statements that appear before each input 
statement in Figure 2-17 are examples of prompts. A prompt is a message displayed for 
the user that requests and describes input. Interactive programs would work without 
prompts, but they would not be as user-friendly. Each prompt in the GetUserInfo class 
ends with two greater-than signs and a space. This punctuation is not required; it just 
separates the words in the prompt from the user’s input value on the screen, improving 
readability. You might prefer to use a series of periods, several dashes, or just a few 
spaces. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





Using the Scanner Class to Accept Keyboard Input D0 


It is legal to write a single prompt that requests multiple input values—for example, “Please 
enter your age, area code, and zip code.” The user could then enter the three values separated 
with spaces, tabs, or Enter key presses. The values would then be interpreted as separate 
tokens and could be retrieved with three separate nextInt( method calls. However, asking a 
user to enter multiple values often leads to mistakes. This book will follow the practice of 


using a separate prompt for each input value required. 79 [_ 





Pitfall: Using nextLine() Following One of the 
Other Scanner Input Methods 


You can encounter a problem when you use one of the numeric Scanner class retrieval 
methods or the next() method before you use the nextLine() method. Consider the 
program in Figure 2-19. It is identical to the one in Figure 2-17, except that the user is 
asked for an age before being asked for a name. (See shading.) Figure 2-20 shows a typical 


execution. 
Don't Do It 
import java.util.Scanner; If you accept numeric input 
public class GetUserInfo2 prior to string input, the 
{ string input is ignored 
public static void main(String[] args) unless you take specia 
{ action 
String name; 
int age; 





Scanner inputDevice = new Scanner 
System.out.print("Please enter y6ur age >> "); 
age = inputDevice.nextIntQ; 
System.out.print("Please enter your name >> "); 
name = inputDevice.nextLineQ); 
System.out.printInC"Your name is " + name + 
"and you are " + age + " years old."); 


Figure 2-19 The GetUserInfo2 class 





a 


Cz\Java>java GetUserInfo2 
mPlease enter your age >> 28 
Please enter your name >> Your name is and you are 28 years old. 





IC :\Java> 











Figure 2-20 Typical execution of the GetUserInfo2 program 
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In Figure 2-20, the user is prompted correctly for an age. However, after the user enters an 
age and the prompt for the name is displayed, the program does not pause to let the user 
enter a name. Instead, the program proceeds directly to the output statement, which does not 
contain a valid name, as you can see in Figure 2-20. 


| 80 When you type characters using the keyboard, they are stored temporarily in a location in 

memory called the keyboard buffer. The keyboard buffer sometimes is called the type-ahead 
buffer. All keystrokes are stored in the keyboard buffer, including the Enter key. The problem 
occurs because of a difference in the way the nextLineQ method and the other Scanner 
retrieval methods work: 





e The Scanner methods nextQ), nextInt(), and nextDouble() retrieve the next token in 
the buffer up to the next whitespace, which might be a space, tab, or Enter key. 


e The nextLineQ) method reads all data up to the Enter key character. 


So, in the execution of the program in Figure 2-20, the user is prompted for an age, types 28, 
and presses Enter. The call to the nextInt() method retrieves the 28 and leaves the Enter key 
press in the input buffer. Then the name prompt is displayed and the call to nextLineO 
retrieves the waiting Enter key before the user can type a name. 


The solution to the problem is simple. After any nextQ, nextInt(Q), or nextDouble() call, 
you can add an extra nextLine() method call that will retrieve the abandoned Enter key 
character. Then, no matter what type of input follows, the program will execute smoothly. 
Figure 2-21 shows a program that contains just one change from Figure 2-19—the addition of 
the shaded statement that retrieves the abandoned Enter key character from the input buffer. 
Although you could assign the Enter key to a character variable, there is no need to do so. 
When you accept an entry and discard it without using it, programmers say that the entry is 
consumed. Figure 2-21 shows that the call to nextInt© accepts the integer, the first call to 
nextLine() accepts the Enter key that follows the integer entry, and the second nextLine() 
call accepts both the entered name and the Enter key that follows it. Figure 2-22 shows that 
the revised program executes correctly. 
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import java.util.Scanner; 
public class GetUserInfo3 
{ 


{ 
String name; 
int age; 


age = inputDevice.nextInt() 
inputDevice.nextLineQ ; 


and you are " + age + 





public static void main(String[] args) 


This statement gets 


Scanner inputDevice = new Scanner(System.in); 
System.out.print("Please enter_yOur age >> "); 


, 


System.out.print("Please enter your name >> "); 
name = inputDevice.nextLineQ; 
System.out.printinC"Your name is name + 


years old. 





Figure 2-21 The GetUserInfo3 class 





C:\Java>java GetUserlInfo3 


Please enter your name >> 


C:o\Java> 


. | 


the integer. 





This statement 
consumes the Enter 
key that follows the 
integer. 


This statement gets 
the name and 
discards the Enter 


key that follows the 
name. 




















Please enter your age >> 28 


ite ma: 


Your name is Julie and you are 28 years 











Figure 2-22 Typical execution of the GetUserInfo3 program 





later in this book. 





old. 


When you write programs that accept user input, there is a risk that the user will enter the wrong type of data. 
For example, if you include a nextInt() method call in your program, but the user types an alphabetic 
character, an error will occur, and your program will stop running. You will learn to handle this type of error 


oo 
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CHAPTER 2 Using Data 


Using the Scanner Class to Accept Keyboard Input 


1. System.in refers to the standard input device, which normally is the 
keyboard. 


2. System.inis more flexible than System. out because it can read all the basic Java 
data types. 


3. When a user types data followed by the Enter key, the Enter key character is left 
in the keyboard buffer after Scanner class methods retrieve the other 
keystrokes. 


"Sayhq AjUO pea 0} pausisap SI uL-waasXs jnq ‘sadA} eyep Snouen Aejdsip ued 
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«a You Do It 


Accepting User Input 


In the next steps you create a program that accepts user input. 


1. Open the IntegerDemo.java file you created in a “You Do It” section earlier in 
this chapter. Change the class name to IntegerDemoInteractive, and save 
the file as IntegerDemolnteractive.java. 


2. As the first line in the file, insert an import statement that will allow you to use 
the Scanner Class: 


import java.util .Scanner; 


3. Remove the assignment operator and the assigned values from each of the 
four numeric variable declarations. 


4. Following the numeric variable declarations, insert a Scanner object 
declaration: 


Scanner input = new Scanner (System. in) ; 


5. Following the variable declarations, insert a prompt for the integer value, and 
an input statement that accepts the value, as follows: 


System.out.print("Please enter an integer >> "); 
anInt = input.nextIntQ); (continues) 
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Then add similar statements for the other three variables: 


System.out.print("Please enter a byte integer >>"); 
aByte = input.nextByteQ() ;5x 

System.out.print("Please enter a short integer >> "); 
aShort = input .nextShortQ); 
System.out.print("Please enter a long integer >>"); 
aLong = input.nextLong() ;sx 


(continued) 


7. Save the file, and then compile and execute it. Figure 2-23 shows a typical 
execution. Execute the program a few more times, using different values 
each time and confirming that the correct values have been accepted from 


the keyboard. 








C:z\Java>java 
Please enter 
Please enter 
Please enter 
Please enter 
int is 
byte is 
short is 





Command Prompt 


IntegerDemolInteractive 

an integer >> 1661 

a byte integer >> 169 

a short integer >> 5672 

a long integer >> 3444872176 
1661 

189 

5672 

34448 72176 








Figure 2-23 Typical execution of the IntegerDemoInteractive program 


Adding String Input 


Next, you add String input to the IntegerDemoInteractive program. 


1. Change the class name of the IntegerDemoInteractive program to 
IntegerDemoInteractiveWithName, and immediately save the file as 
IntegerDemolnteractiveWithName.java. 


2. Add anew variable with the other variable declarations as follows: 


String name; 


3. After the last input statement (that gets the value for aLong), add three statements 
that prompt the user for a name, accept the name, and use the name as follows: 


System.out.print("Please enter your name >> "); 
name = input.nextLineQ ; 
System.out.printIinC"Thank you, " + name) ; 
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(continues) 
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CHAPTER2 | 


Using Data 


(continued) 


4. Save the file, and compile and execute it. Figure 2-24 shows a typical execution. 


_E 





You can enter the numbers, but when the prompt for the name appears, you are 
not given the opportunity to respond. Instead, the string "Thank you", 


including 


the ending comma and space, is output immediately, and the program ends. 
This output is incorrect because the input statement that should retrieve the 
name from the keyboard instead retrieves the Enter key that was still in the 
keyboard buffer after the last numeric entry. 





r 


Ci\Java> java 
Please enter 
Please enter 
Please enter 
Please enter 
Please enter 
int is 
byte is 
short is 
long is 


C:\Java> 


fay Command Prompt 





=. ox 


IntegerDemoInteract iveWlit hName 
an integer >> 525 

a byte integer >> 36 

a short integer >> 72 

a long integer >> 7329 

your name >> Thank you, 

525 

36 

?2 

7329 











Figure 2-24 Typical execution of incomplete IntegerDemoInteractiveWi thName 
application that does not accept a name 


5. To fix the problem, insert an extra call to the nextLine() method just before 
the statement that accepts the name. This call will consume the Enter key. 
You do not need an assignment operator with this statement, because there 
is no need to store the Enter key character. 


input .nextLineQ); 
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). Editorial review has 
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(continued) 


6. Save, compile, and execute the program. Figure 2-25 shows a typical successful 


execution. 
85 Zz 
= 


fay Command Prompt 








C:\Java>java IntegerDemolInteract iveWlit hName 
enter an integer >> 814 
enter a byte integer >> 52 
enter a short integer >> 198 
enter a long integer >> 129654 
enter your name >> Sarah 
Thank you, Sarah 
int is $14 
byte is 52 
short is 1906 
long is 129654 











Figure 2-25 Typical successful execution of IntegerDemoInteractiveWi thName 
application 


Using the JOptionPane Class to Accept GUI Input 


In Chapter 1, you learned how to display output at the command line and how to create GUI 
message boxes to display String objects. Earlier in this chapter, you learned to accept input 
from the keyboard at the command line. You also can accept input in a GUI dialog box using 
the JOptionPane class. 


Two dialog boxes that can be used to accept user input are: 
e InputDialog—Prompts the user for text input 


e ConfirmDialog—Asks the user a question, providing buttons that the user can click for 
Yes, No, and Cancel responses 


Using Input Dialog Boxes 


An input dialog box asks a question and provides a text field in which the user can enter a 
response. You can create an input dialog box using the showInputDialog() method. Six versions 
of this method are available, but the simplest version uses a single argument that is the prompt 
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you want to display within the dialog box. The showInputDialog() method returns a String 
that represents a user’s response; this means that you can assign the showInputDialog() 
method to a String variable and the variable will hold the value that the user enters. 


For example, Figure 2-26 shows an application that creates an input dialog box containing a 
mo | prompt for a first name. When the user executes the application, types “William”, then clicks 

the OK button or presses Enter on the keyboard, the response String will contain “William”. 
In the application in Figure 2-26, the response is concatenated with a welcoming message and 
displayed in a message dialog box. Figure 2-27 shows the dialog box containing a user’s 
response, and Figure 2-28 shows the resulting output message box. 





import javax.swing.JOptionPane; 
public class HelloNameDialog 


if 


public static void main(String[] args) 

{ 
String result; 
result = JOptionPane.showInputDialog(null, "What is your name?"); 
JOptionPane.showMessageDialog(null, "Hello, " + result + "!"); 





Figure 2-26 The HelloNameDialog class 


What is your name? 








Figure 2-27 Input dialog box of the Hel loNameDialog application 





Figure 2-28 Output of the Hel ]oNameDialog application 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Using the JOptionPane Class to Accept GUI Input D0 


Within the JOptionPane class, one version of the showInputDialog() method allows the 
programmer flexibility in controlling the appearance of the input dialog box. The version of 
showInputDialog() that requires four arguments can be used to display a title in the dialog 
box title bar and a message that describes the type of dialog box. The four arguments to 





showInputDialog() include: 
87 
e The parent component, which is the screen component, such as a frame, in front of which 7 
the dialog box will appear. If this argument is null, the dialog box is centered on the 
screen. 


e The message the user will see before entering a value. Usually this message is a String, 
but it actually can be any type of object. 


e The title to be displayed in the title bar of the input dialog box. 

e Acclass field describing the type of dialog box; it can be one of the following: 
ERROR_MESSAGE, INFORMATION _MESSAGE, PLAIN_MESSAGE, QUESTION_MESSAGE, or 
WARNING_MESSAGE. 

For example, when the following statement executes, it displays the input dialog box shown in 

Figure 2-29. 


JOptionPane. showInputDialog(null, 
"What is your area code?", 
"Area code information", 
JOptionPane.QUESTION_MESSAGE) ; 


Note that the title bar displays “Area code information,” and the dialog box shows a question 
mark icon. 





- 


Area code information [nese] 


What is your area code? 


| 


Figure 2-29 An input dialog box with a String in the title bar and a question mark icon 











The showInputDialog() method returns a String object, which makes sense when you 
consider that you might want a user to type any combination of keystrokes into the dialog 
box. However, when the value that the user enters is intended to be used as a number, as in an 
arithmetic statement, the returned String must be converted to the correct numeric type. 
Later in this chapter, you will learn how to change primitive data from one data type to 
another. However, the techniques you will learn work only with primitive data types— 
double, int, char, and so on—not with class objects (that are reference types) such as 

a String. To convert a String to an integer or double, you must use methods from the 
built-in Java classes Integer and Double. Each primitive type in Java has a corresponding 
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class contained in the java. lang package; like most classes, the names of these classes begin 
with uppercase letters. These classes are called type-wrapper classes. They include methods 
that can process primitive type values. 


Figure 2-30 shows a SalaryDialog application that contains two String objects— 
wageString and dependentsString. Two showInputDialog() methods are called, and the 
answers are stored in the declared Strings. The shaded statements in Figure 2-30 show how 
the Strings are converted to numeric values using methods from the type-wrapper classes 
Integer and Double. The double value is converted using the Double. parseDouble() 
method, and the integer is converted using the Integer.parseInt() method. Figure 2-31 
shows a typical execution of the application. 


though no objects of the class exist. You can tell that the method Double. parseDoubleQ) is a 
static method, because the method name is used with the class name Doub] e—no object is needed. 
Similarly, you can tell that Integer.parseIntQ) is also a static method. 


Q Remember that in Java, the reserved keyword static means that a method is accessible and usable even 


deconstructing it so as to describe its grammatical components. Parsing a String converts it to its 


The term parse means to break into component parts. Grammarians talk about “parsing a sentence’— 
Y numeric equivalent. 


import javax.swing.JOptionPane; 
public class SalaryDialog 
{ 
public static void main(String[] args) 
{ 
String wageString, dependentsString; 
double wage, weeklyPay; 
int dependents; 
final double HOURS_IN_ WEEK = 37.5; 
wageString = JOptionPane.showInputDialog(null, 
“Enter employee's hourly wage", "Salary dialog 1", 
JOptionPane. INFORMATION_MESSAGE) ; 
weeklyPay = Double.parseDouble(wageString) * 
HOURS_IN_WEEK; 
dependentsString = JOptionPane.showInputDialog(null, 
“How many dependents?", "Salary dialog 2", 
JOptionPane.QUESTION_MESSAGE) ; 
dependents = Integer.parseInt(dependentsString) ; 
JOptionPane.showMessageDialog(null, "Weekly salary is $" + 
weeklyPay + "\nDeductions will be made for " + 
dependents + " dependents"); 





Figure 2-30 The SalaryDialog class 
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@® Enter employee's hourly wage [2] How many dependents? 
[10.50 


2 



































o 





Message 


@® Weekly salary is $393.75 
Deductions will be made for 2 dependents 





Figure 2-31 Sample execution of the SalaryDialog application 


Using Confirm Dialog Boxes 


Sometimes, the input you want from a user does not have to be typed from the keyboard. 
When you present simple options to a user, you can offer buttons that the user can click to 
confirm a choice. A confirm dialog box displays the options Yes, No, and Cancel; you can 
create one using the showConfirmDialog() method in the JOptionPane class. Four versions 
of the method are available; the simplest requires a parent component (which can be null) 
and the String prompt that is displayed in the box. The showConfirmDialog() method 
returns an integer containing one of three possible values: JOptionPane.YES_OPTION, 
JOptionPane.NO_OPTION, or JOptionPane.CANCEL_OPTION. Figure 2-32 shows an 
application that asks a user a question. The shaded statement displays the dialog box shown 
in Figure 2-33 and stores the user’s response in the integer variable named selection. 


import javax.swing.JOptionPane; 
public class AirlineDialog 
{ 
public static void main (String[] args) 
{ 
int selection; 
boolean isYes; 


selection = JOptionPane.showConfirmDialog(null, 
"Do you want to upgrade to first class?"); 
isYes = (selection == JOptionPane.YES_ OPTION) ; 
JOptionPane.showMessageDialog(null, 
"You responded " + isYes); 





Figure 2-32 The AirlineDialog class 
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Select an Option Es 


[2| Do you want to upgrade to first class? 








Yes | No || cancel 











Figure 2-33 The confirm dialog box displayed by the AirlineDialog application 


After a value is stored in selection, a Boolean variable named isYes is set to the result when 
selection and JOptionPane.YES_OPTION are compared. If the user has selected the Yes 
button in the dialog box, this variable is set to true; otherwise, the variable is set to false. 
Finally, the true or false result is displayed; Figure 2-34 shows the result when a user clicks the 
Yes button in the dialog box. 





ran 


Message 


@ You responded true 


Figure 2-34 Output of AirlineDialog application when user clicks Yes 








You can also create a confirm dialog box with five arguments, as follows: 
e The parent component, which can be null 

e The prompt message 

e The title to be displayed in the title bar 


e Aninteger that indicates which option button will be shown (It should be one of the class 
variables YES_NO_CANCEL_OPTION or YES_NO_OPTION.) 


e An integer that describes the kind of dialog box (It should be one of the class variables 
ERROR_MESSAGE, INFORMATION_MESSAGE, PLAIN_MESSAGE, QUESTION_MESSAGE, or 
WARNING MESSAGE.) 


When the following statement is executed, it displays a confirm dialog box, as shown in Figure 2-35: 


JOptionPane. showConfirmDialog(null, 
"A data input error has occurred. Continue?", 
"Data input error", JOptionPane.YES_NO_ OPTION, 
JOptionPane.ERROR_MESSAGE) ; 


Note that the title bar displays “Data input error,” the Yes and No buttons appear, and the 
dialog box shows the error message, “A data input error has occurred. Continue?” It also 
displays the octagonal ERROR_MESSAGE icon. 
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Data input error xa 


() A data input error has occurred. Continue? 


Figure 2-35 Confirm dialog box with title, Yes and No buttons, and error icon 








Confirm dialog boxes provide more practical uses when your applications can make decisions based on the 
Y users’ responses. In the chapter Making Decisions, you will learn how to make decisions within programs. 


Using the JOptionPane Class to Accept GUI Input 
1. You can create an input dialog box using the showInputDialog() method; the 
method returns a String that represents a user’s response. 


2. You can use methods from the Java classes Integer and Double when you want to 
convert a dialog box’s returned values to numbers. 


3. Aconfirm dialog box can be created using the showConfirmDialog() method in 
the JOptionPane class; a confirm dialog box displays the options Accept, Reject, 
and Escape. 


‘Ja0ue9D 
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ee : : 
a" Watch the video Getting Input. 


Performing Arithmetic 


Table 2-8 describes the five standard arithmetic operators that you use to perform calculations 
with values in your programs. A value used on either side of an operator is an operand. For 
example, in the expression 45 + 2, the numbers 45 and 2 are operands. The arithmetic operators are 
examples of binary operators, so named because they require two operands. 


Q You will learn about the Java shortcut arithmetic operators in the chapter Looping. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 2 Using Data 


oo 





Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves th 





Operator Description Example 
+ Addition 45 + 2, the result is 47 
- Subtraction 45 - 2, the result is 43 
. Multiplication 45 * 2, the result is 90 
/ Division 45.0 / 2, the result is 22.5 
A5 / 2, the result is 22 (not 22.5) 
% Remainder (modulus) 45 % 2, the result is 1 (that is, 45 / 2 = 22 witha 


remainder of 1) 


Table 2-8 Arithmetic operators 


The operators / and % deserve special consideration. Java supports two types of division: 


e Floating-point division occurs when either or both of the operands are floating-point 
values. For example, 45.0 / 2 is 22.5. 


e Integer division occurs when both of the operands are integers. The result is an integer, 
and any fractional part of the result is lost. For example, the result of 45 / 2 is 22. As 
another example, 39 / 5 is 7 because 5 goes into 39 seven whole times; 38 / 5, 37 / 5, 36/5, 
and 35 / 5 all evaluate to 7. 


The percent sign is the remainder operator. The remainder operator is most often used with 
two integers, and the result is an integer with the value of the remainder after division takes 
place. For example, the result of 45 % 2 is 1 because 2 “goes into” 45 twenty-two times with a 
remainder of 1. Other examples of remainder operations include the following: 


e 39% 5 is 4 because 5 goes into 39 seven times with a remainder of 4. 


e 20% 3 is 2 because when 20 is divided by 3, the remainder is 2. 36 % 4 is 0 because there is 
no remainder when 4 is divided into 36. 


Note that when you perform paper-and-pencil division, you divide first to determine a 
remainder. In Java, you do not need to perform a division operation before you can perform a 
remainder operation. A remainder operation can stand alone. 


Although the remainder operator is most often used with integers, it is legal but less often 
useful to use the operator with floating-point values. In Java, when you use the % operator 
with floating-point values, the result is the remainder from a rounded division. 


would argue that remainder is the better term because in Java, the result of using the remainder operator 


The remainder operator is also called the modulus operator, or sometimes just mod. Mathematicians 
Y can be negative, but in mathematics, the result of a modulus operation can never be negative. 
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Associativity and Precedence 


When you combine mathematical operations in a single statement, you must understand 
both associativity and precedence. The associativity of arithmetic operators with the same 
precedence is left-to-right. In a statement such as answer =x +y+z;, the x and y are added 
first, producing a temporary result, and then z is added to the temporary sum. After the sum 93 [ 
is computed, the result is assigned to answer. 





Operator precedence refers to the rules for the order in which parts of a mathematical 
expression are evaluated. The multiplication, division, and remainder operators have the 
same precedence. Their precedence is higher than that of the addition and subtraction 
operators. Addition and subtraction have the same precedence, and their precedence is lower 
than that of the other operators. In other words, expressions are evaluated from left to right, 
and multiplication, division, and remainder always take place prior to addition or subtraction. 
Table 2-9 summarizes the precedence of the arithmetic operators. 





Operators Descriptions Relative Precedence 
*1% Multiplication, division, remainder Higher 
+- Addition, subtraction Lower 


Table 2-9 Relative precedence of arithmetic operators 


For example, the following statement assigns 14 to result: 
int result = 2 + 3 * 4; 


The multiplication operation (3 * 4) occurs before adding 2. You can override normal 
operator precedence by putting the operation to perform first in parentheses. The following 
statement assigns 20 to result: 


int result = (2 + 3) * 4; 


The addition within the parentheses takes place first, and then the intermediate result (5) is 
multiplied by 4. When multiple pairs of parentheses are used in a statement, the innermost 
expression surrounded by parentheses is evaluated first. For example, the value of the 
following expression is 46: 


2* (3 + (4 * 5)) 


First, 4 * 5 evaluates to 20, and then 3 is added, giving 23. Finally, the value is multiplied by 2, 
giving 46. 


Remembering that *, /, and % have the same precedence is important in arithmetic 
calculations. These operations are performed from left to right, regardless of the order in 
which they appear. For example, the value of the following expression is 9: 


25 / 8 * 3 


First, 25 is divided by 8. The result is 3 because with integer division, you lose any remainder. 
Then 3 is multiplied by 3, giving 9. If you assumed that multiplication was performed before 
division, you would calculate an incorrect answer. 
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Q You will learn more about operator precedence in the chapter Making Decisions. 





a 94 Writing Arithmetic Statements Efficiently 


You can make your programs operate more efficiently if you avoid unnecessary repetition of 
arithmetic statements. For example, suppose you know the values for an employee’s hourly 

pay and pay rate and you want to compute state and federal withholding tax based on known 
rates. You could write two statements as follows: 


statewithholding = hours * rate * STATE_RATE; 
federalWithholding = hours * rate * FED_RATE; 


With this approach, you perform the multiplication of hours * rate twice. It is more efficient 
to perform the calculation once, as follows: 
grossPay = hours * rate; 


stateWithholding = grossPay * STATE_RATE; 
federalWithholding = grossPay * FED_RATE; 


The time saved is very small, but these savings would be more important if the calculation 
was more complicated or if it was repeated many times in a program. As you think about the 
programs you write, remain on the lookout for ways to improve efficiency by avoiding 
duplication of operations. 


Pitfall: Not Understanding Imprecision in Floating-Point Numbers 


Integer values are exact, but floating-point numbers frequently are only approximations. For 
example, when you divide 1.0 by 3.0, the mathematical result is 0.3333333..., with the 3s 
continuing infinitely. No matter how many decimal places you can store, the result is only an 
approximation. Even values that don’t repeat indefinitely in our usual numbering system, 
such as 0.1, cannot be represented precisely in the binary format used by computers. 
Imprecision leads to several problems: 


Appendix B provides a more thorough explanation of numbering systems and why fractional values cannot be 
GY represented accurately. 


e When you produce floating-point output, it might not look like what you expect or 
want. 


e When you make comparisons with floating-point numbers, the comparisons might not be 
what you expect or want. 


For example, Figure 2-36 shows a class in which an answer is computed as 2.20 — 2.00. 
Mathematically, the result should be 0.20. But, as the output in Figure 2-37 shows, the result 
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is calculated as a value that is slightly more than 0.20, and when answer is compared to 0.20, 
the result is false. 





public class ImprecisionDemo 


{ 95 L_ 
public static void main(String[] args) 





{ 
double answer = 2.20 - 2.00; 
boolean isEqual = answer == 0.20; 
System.out.printInC"answer is " + answer); 
System.out.printInC"isEqual is " + isEqual); 

} | 








Figure 2-36 The ImprecisionDemo program 





va 


Command Prompt 


C:\Java>java ImprecisionDemo 
answer is 6.266606660600006018 
isEqual is false 








Figure 2-37 Execution of the ImprecisionDemo program 


For now, you might choose to accept the slight imprecisions generated when you use 
floating-point numbers. However, if you want to eliminate the imprecisions, you can use 
one of several techniques to round values. Appendix C contains directions on how to round 
numbers and how to format a floating-point number so it displays the desired number of 
decimal positions. 


Up Several movies have used the fact that floating-point numbers are not precise as a plot element. For 


V4 example, in the movies Superman Ill and Office Space, thieves round currency values and divert the 
'@y, remaining fractions of cents to their own accounts. 


= Watch the video Arithmetic. 
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Performing Arithmetic 





| 96 1. The arithmetic operators are examples of unary operators, which are so named 
because they perform one operation at a time. 


2. In Java, operator precedence dictates that multiplication, division, and remainder 
always take place prior to addition or subtraction in an expression. 


3. Floating-point arithmetic might produce imprecise results. 
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«a You Do It 


Using Arithmetic Operators 


In these steps, you create a program that uses arithmetic operators. 


1. Open anew file in your text editor, and type the import statement needed for 
interactive input with the Scanner class: 


import java.util .Scanner; 


2. Type the class header and its curly braces for a class named ArithmeticDemo. 
Within the class’s curly braces, enter the main© method header and its 
braces. 


public class ArithmeticDemo 

{ 
public static void main(String[] args) 
{ 
} 

} 


3. With the main© method, declare five int variables that will be used to hold 
two input values and their sum, difference, and average: 


int firstNumber; 

int secondNumber; 

int sum; 

int difference; 

int average; : 
(continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


(continued) 


4. Also declare a Scanner object so that keyboard input can be accepted. 
Scanner input = new Scanner (System. in) ; 

5. Prompt the user for and accept two integers: 7 
System.out.print("Please enter an integer >> "); 
firstNumber = input .nextIntQ; 


System.out.print("Please enter another integer >> "); 
secondNumber = input.nextIntQ) ; 





6. Add statements to perform the necessary arithmetic operations: 


sum = firstNumber + secondNumber; 
difference = firstNumber - secondNumber; 
average = sum / 2; 


7. Display the three calculated values: 


System.out.printIn(firstNumber + "+" + 
secondNumber +" is "+ sum); 

System.out.printIn(firstNumber +" - "+ 
secondNumber +" is " + difference); 

System.out.printInC"The average of " + firstNumber + 
"and " + secondNumber + " is " + average) ; 


8. Save the file as ArithmeticDemo.java, and then compile and execute it. Enter 
values of your choice. Figure 2-38 shows a typical execution. Notice that 
because integer division was used to compute the average, the answer is an 
integer. 





Ga 


fay Command Prompt 


C:\Java>java ArithmeticDemo 

Please enter an integer >> 14 
Please enter another integer >> 11 
i ee he ee k-4. 
id - 11 is 3 

The average of 14 and 11 is 12 


C:2\Java> 














Figure 2-38 Typical execution of Ari thmeticDemo application 


9. Execute the program multiple times using various integer values and confirm 
that the results are accurate. 


(continues) 
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(continued) 


Performing Floating-Point Arithmetic 


Next, you will modify the ArithmeticDemo application to work with floating-point values 
instead of integers. 


1. Within the ArithmeticDemo application, change the class name to 
ArithmeticDemo2, and immediately save the file as ArithmeticDemo2.java. 
Change all the variables’ data types to double. Change the two prompts to request 
double values, and change the two calls to the nextInt © method to nextDouble(). 
Save, compile, and execute the program again. Figure 2-39 shows a typical 
execution. Notice that the average calculation now includes decimal places. 





- 
fay Command Prompt 


C:\Java>java Arithmet icDemo2 

Please enter a double >> 15.5 
Please enter another double >> 3.4 
15.5 + 3.4 is 18.9 

15.5 — 3.4 is 12.1 

The average of 15.5 and 3.4 is ?.45 


Ci\Java>_ 














Figure 2-39 Typical execution of the ArithmeticDemo2 application 


2. Rerun the program, experimenting with various input values. Some of your output 
might appear with imprecisions similar to those shown in Figure 2-40. If you are 
not satisfied with the slight imprecisions created when using floating-point arithmetic, 
you can round or change the display of the values, as discussed in Appendix C. 


- 
fay Command Prompt ~» le) 


C:\Java>java ArithmeticDemo2 

Please enter a double >> 16.4 

Please enter another double >> 2.2 

16.4 + 2.2 is 18.599999999999998 

Mi6.4 — 2.2 is 14.2 

The average of 16.4 and 2.2 is ?.299999999999999 





Bc:\Java> 








Figure 2-40 Another typical execution of the Ari thmeticDemo2 application 
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Understanding Type Conversion 


When you perform arithmetic with variables or constants of the same type, the result of the 
operation retains the same type. For example, when you divide two ints, the result is an int, 
and when you subtract two doubles, the result is a double. Often, however, you might want 
to perform mathematical operations on operands with unlike types. The process of 99 [ 
converting one data type to another is type conversion. Java performs some conversions for 

you automatically or implicitly, but other conversions must be requested explicitly by the 

programmer. 





Automatic Type Conversion 


When you perform arithmetic operations with operands of unlike types, Java chooses a 
unifying type for the result. The unifying type is the type to which all operands in an 
expression are converted so that they are compatible with each other. Java performs an 
implicit conversion; that is, it automatically converts nonconforming operands to the unifying 
type. Implicit conversions also are called promotions. Figure 2-41 shows the order for 
establishing unifying types between values. 


double Highest 
float 

long | 
int Lowest 


(short and byte are automatically converted to int when used in 
expressions) 








Figure 2-41 Order for establishing unifying data types 


When two unlike types are used in an expression, the unifying type is the one that is higher in 
the list in Figure 2-41. In other words, when an operand that is a type lower on the list is 
combined with a type that is higher, the lower-type operand is converted to the higher one. 
For example, the addition of a double and an int results in a double, and the subtraction of a 
long from a float results in a float. 


Boolean values cannot be converted to another type. In some languages, such as C++, Boolean values are 
Y actually numbers. However, this is not the case in Java. 
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For example, assume that an int, hoursWorked, and a double, payRate, are defined and then 
multiplied as follows: 


int hoursWorked = 37; 
double payRate = 6.73; 
double grossPay = hoursWorked * payRate; 
100 





The result of the multiplication is a double because when a double and an int are multiplied, 
the int is promoted to the higher-ranking unifying type double—the type that is higher in 
the list in Figure 2-41. Therefore, assigning the result to grossPay is legal. 


The following code will not compile because hoursWorked times payRate is a double, and 
Java does not allow the loss of precision that occurs if you try to store the calculated double 
result in an int. 

int hoursWorked = 37; 


double payRate = 6.73; 
int grossPay = hoursWorked * payRate; 


The data types char, short, and byte all are promoted to int when used in statements with 
unlike types. If you perform a calculation with any combination of char, short, and byte 
values, the result is an int by default. For example, if you add two bytes, the result is an int, 
not a byte. 


Explicit Type Conversions 


You can purposely override the unifying type imposed by Java by performing a type cast. 
Type casting forces a value of one data type to be used as a value of another type. To perform 
a type cast, you use a cast operator, which is created by placing the desired result type in 
parentheses. Using a cast operator is an explicit conversion. The cast operator is followed by 
the variable or constant to be cast. For example, a type cast is performed in the following 
code: 


Il 


double bankBalance 189.66; 
float weeklyBudget = (float) (bankBalance / 4); 
// weeklyBudget is 47.415, one-fourth of bankBalance 


requires two operands, a unary operator uses only one operand. The unary cast operator is followed by 


The cast operator is more completely called the unary cast operator. Unlike a binary operator that 
Y its operand. 


In this example, the double value bankBalance is divided by the integer 4, and the result is a 
double. Then the double result is converted to a float before it is stored in weeklyBudget. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Understanding Type Conversion D0 


Without the conversion, the statement that assigns the result to weeklyBudget would not 
compile. Similarly, a cast from a float to an int occurs in this code segment: 
float myMoney = 47.82f; 
int dollars = (int) myMoney; 
// dollars is 47, the integer part of myMoney 
101 








In this example, the float value myMoney is converted to an int before it is stored in the 
integer variable named dollars. When the float value is converted to an int, the decimal 
place values are lost. The cast operator does not permanently alter any variable’s data type; 
the alteration is only for the duration of the current operation. 


The word cast is used in a similar fashion when referring to molding metal, as in cast iron. In a Java 
arithmetic cast, a value is “molded” into a different type. 


int value is 2,147,483,647, so the following statements produce distorted results: 


Q It is easy to lose data when performing a cast. For example, the largest byte value is 127 and the largest 


int anOkayInt = 200; 


byte aBadByte (byte) anOkayInt; 


A byte is constructed from eight 1s and Os, or binary digits. The first binary digit, or bit, holds a O or 1 to 
represent positive or negative. The remaining seven bits store the actual value. When the integer value 200 
is stored in the byte variable, its large value consumes the eighth bit, turning it to a 1, and forcing the 
aBadByte variable to appear to hold the value -72, which is inaccurate and misleading. 


You do not need to perform a cast when assigning a value to a higher unifying type. For 
example, when you write a statement such as the following, Java automatically promotes the 
integer constant 10 to be a double so that it can be stored in the payRate variable: 


double payRate = 10; 

However, for clarity, if you want to assign 10 to payRate, you might prefer to write the 
following: 

double payRate = 10.0; 


The result is identical whether you assign the literal double 10.0 or the literal int 10 to the 
double variable. 
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Understanding Type Conversion 


102 1. When you perform arithmetic operations with operands of unlike types, you must 
make an explicit conversion to a unifying type. 





Summing a double, int, and float results in a double. 


3. You can explicitly override the unifying type imposed by Java by performing a 
type cast; type casting forces a value of one data type to be used as a value of 
another type. 


"adA} SUIAJIUN & 0} UOISJBAUOD HOI! Ue SWUOPad ener ‘sadA} ayljuN Jo 
Spuesado YyIM SUO}eJado DaWYJUe WUOLed NOK uaYy *T# SI JUaLWAa}e}S asje} aU. 


<n You Do It 


Implicit and Explicit Casting 


In this section you explore the concepts of the unifying types and casting. 


1. Open the ArithmeticDemo.java file that uses integer values to calculate a 
sum, difference, and average. Change the class name to ArithmeticDemo3, 
and immediately save the file as ArithmeticDemo3.java. 


2. Inthe previous version of the program, the average was calculated without 
decimal places because when two integers are divided, the result is an 
integer. To compute a more accurate average, change the data type for the 
average variable from int to double. 


3. Save, compile, and execute the program. As the sample execution in Figure 2-42 
shows, the program compiles and executes, but the average is still not accurate. 
The average of 20 and 19 is calculated to be just 19 because the decimal 
portion of the arithmetic result is lost. The program executes because the result 
of an integer divided by an integer is an integer, and when the integer is assigned 
to the double, automatic type conversion takes place. 


(continues) 
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Command Prompt 


C:\Java>java ArithmeticDemo3 103 
Please enter an integer >> 286 
Please enter another integer >> 19 
26 +19 is 39 

26-19 is 1 

The average of 26 and 19 is 19 








C:\Java> 








Figure 2-42 Typical execution of Ari thmeticDemo3 application 


4. Change the statement that computes the average to include a cast as follows: 


average = (double) sum / 2; 


5. Save, compile, and execute the program. As shown in Figure 2-43, now the 
program displays a more accurate average. The integer sum has been cast to a 
double, and when the double is divided by the integer, the result is a double, 
which is then assigned to average. 





Command Prompt . 2/2 






C:\Java>java ArithmeticDemo3 
Please enter an integer >> 20 
Please enter another integer >> 19 


The average of 26 and 19 is 19.5 
C:\Java> 





Figure 2-43 Typical execution of ArithmeticDemo3 application after addition of a cast 
operation for the average 


6. Change the statement that computes the average to include a second set of 
parentheses, as follows: 


average = (double) (sum / 2); 
(continues) 
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(continued) 


7. Save, compile, and execute the program. Now, the fractional portion of the result 
is omitted again. That’s because the result of sum / 2 is calculated first, and the 
result is an integer. Then the whole-number result is cast to a double and assigned 
to a double—but the fractional part of the answer was already lost and casting is 
too late. Remove the newly added parentheses, save the program, compile it, and 
execute it again to confirm that the fractional part of the answer is reinstated. 


8. As an alternative to the explicit cast in the division statement in the 
ArithmeticDemo program, you could write the average calculation as follows: 


average = sum / 2.0; 


In this calculation, when the integer sum is divided by the double constant 2.0, 
the result is a double. The result then does not require any cast to be assigned 
to the double average without loss of data. Try this in your program. 


9. Go to the Java Web site (www.oracle.com/Aechnetwork/java/index.html), 
select Java APIs, and then select Java SE 7. Scroll through the list of 
All Classes, and select PrintStream, which is the data type for the out object 
used with the printIn© method. Scroll down to view the list of methods in the 
Method Summary. As you did in a previous exercise, notice the many versions of 
the printQ and printIn© methods, including ones that accept a String, an int, 
and a long. Notice, however, that no versions accept a byte or a short. That’s 
because when a byte Or short IS sent to the printQ Or printIn© method, it is 
automatically promoted to an int, so that version of the method is used. 


Don't Do It 


Don’t mispronounce “integer.” People who are unfamiliar with the term often say 
“interger,” inserting an extra r. 


Don’t attempt to assign a literal constant floating-point number, such as 2.5, to a float 
without following the constant with an uppercase or lowercase F. By default, constant 
floating-point values are doubles. 


Don’t try to use a Java keyword as an identifier for a variable or constant. Table 1-1 in 
Chapter 1 contains a list of Java keywords. 


Don’t attempt to assign a constant value under —2,147,483,648 or over +2,147,483,647 toa 
Tong variable without following the constant with an uppercase or lowercase L. By default, 
constant integers are ints, and a value under —2,147,483,648 or over 2,147,483,647 is too 
large to be an int. 


Don’t assume that you must divide numbers as a step to determining a remainder; the 
remainder operator (% ) is all that’s needed. 
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e Don't try to use a variable or named constant that has not yet been assigned a value. 


e Don't forget to consume the Enter key after numeric input using the Scanner class when a 
nextLine() method call follows. 


e Don't forget to use the appropriate import statement when using the Scanner or 
JOptionPane class. 105 








e Don't forget precedence rules when you write statements that contain multiple arithmetic 
operations. For example, score1+score2 / 2 does not compute the average of two scores. 
Instead, it adds half of score2 to scorel. To compute the average, you would write 
(scorel + score2) / 2. 


e Don't forget that integer division results in an integer, dropping any fractional part. For 
example, 1 / 2 is not equal to 0.5; it is equal to 0. 


e Don’t forget that extra parentheses can change the result of an operation that includes casting. 
e Don't forget that floating-point numbers are imprecise. 


e Don’t attempt to assign a constant decimal value to an integer using a leading 0. For 
example, if you declare int num=021; and then display num, you will see 17. The leading 0 
indicates that the value is in base 8 (octal), so its value is two 8s plus one J. In the decimal 
system, 21 and 021 mean the same thing, but not in Java. 


e Don't use a single equal sign ( = ) in a Boolean comparison for equality. The operator used 
for equivalency is composed of two equal signs ( == ). 


e Don't try to store a string of characters, such as a name, in a char variable. A char variable 
can hold only a single character. 


e Don’t forget that when a String and a numeric value are concatenated, the resulting 
expression is a string. For example, "X" + 2 +4 results in "X24", not "X6". If you want the 
result to be "X6", you can use the expression "X" + (2 + 4). 





Key Terms 


Constant describes values that cannot be changed during the execution of an application. 









A literal constant is a value that is taken literally at each use. 

A numeric constant is a number whose value is taken literally at each use. 
An unnamed constant has no identifier associated with it. 

A variable is a named memory location that you can use to store a value. 


An item’s data type describes the type of data that can be stored there, how much memory 
the item occupies, and what types of operations can be performed on the data. 


A primitive type is a simple data type. Java’s primitive types are byte, short, int, long, float, 
double, char, and boolean. 
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Reference types are complex data types that are constructed from primitive types. 
A variable declaration is a statement that reserves a named memory location. 


A strongly typed language is one in which each variable has a well-defined type that limits 
the operations you can perform with it; strong typing implies that variables must be declared 
106 before they can be used. 





Camel casing is a style in which an identifier begins with a lowercase letter and subsequent 
words within the identifier are capitalized. 


The assignment operator is the equal sign ( = ); any value to the right of the equal sign is 
assigned to the variable on the left of the equal sign. 


An initialization is an assignment made when you declare a variable. 

An assignment is the act of providing a value for a variable. 

Associativity refers to the order in which operands are used with operators. 

An lvalue is an expression that can appear on the left side of an assignment statement. 

An rvalue is an expression that can appear only on the right side of an assignment statement. 
An uninitialized variable is one that has not been assigned a value. 

A garbage value is the unknown value stored in an uninitialized variable. 


A named constant is a named memory location whose value cannot change after it is 
assigned. 


A symbolic constant is a named constant. 
The keyword final precedes named constant declarations. 
A blank final is a final variable that has not yet been assigned a value. 


A magic number is a value that does not have immediate, intuitive meaning or a number 
that cannot be explained without additional knowledge. Unnamed constants are magic 
numbers. 


The scope of a data item is the area in which it is visible to a program and in which you can 
refer to it using its simple identifier. 










A block of code is the code contained between a set of curly braces. 
Concatenated describes values that are attached end to end. 


A null String is an empty String created by typing a set of quotes with nothing between 
them. 


An integer is a whole number without decimal places. 


The int data type is used to declare variables and constants that store integers in the range 
of —2,147,483,648 to +2,147,483,647. 
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The byte data type holds very small integers, from —128 to 127. 
The short data type holds small integers, from —32,768 to 32,767. 


The long data type holds very large integers, from -9,223,372,036,854,775,808 to 


9,223,372,036,854,775,807. 
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A boolean variable can hold only one of two values—true or false. 


A relational operator compares two items; an expression that contains a relational operator 
has a Boolean value. 


A comparison operator is another name for a relational operator. 
A floating-point number contains decimal positions. 


A float data type can hold a floating-point value of up to six or seven significant digits of 
accuracy. 


A double data type can hold a floating-point value of up to 14 or 15 significant digits of 
accuracy. 


Significant digits refers to the mathematical accuracy of a value. 


Scientific notation is a display format that more conveniently expresses large or small 
numeric values; a multidigit number is converted to a single-digit number and multiplied by 
10 to a power. 


A double-precision floating-point number is stored in a double. 
A single-precision floating-point number is stored in a float. 
The char data type is used to hold any single character. 


String is a built-in Java class that provides you with the means for storing and manipulating 
character strings. 


An escape sequence begins with a backslash followed by a character; the pair represents a 
single character. 


The standard input device normally is the keyboard. 











A token is a unit of data separated with whitespace. 
A prompt is a message that requests and describes user input. 


Echoing the input means to repeat the user’s entry as output so the user can visually confirm 
the entry’s accuracy. 


The keyboard buffer is a small area of memory where keystrokes are stored before they are 
retrieved into a program. 


The type-ahead buffer is the keyboard buffer. 


To consume an entry is to retrieve and discard it without using it. 
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An input dialog box asks a question and provides a text field in which the user can enter a 
response. 


The showInputDialog() method creates an input dialog box. 


Type-wrapper classes, contained in the java. lang package, include methods that can 
108 process primitive type values. 





To parse means to break into component parts. 


A confirm dialog box displays the options Yes, No, and Cancel; you can create one using the 
showConfirmDialog() method in the JOptionPane class. 


Standard arithmetic operators are used to perform calculations with values. 
An operand is a value used in an arithmetic statement. 
Binary operators require two operands. 


Floating-point division is the operation in which two values are divided and either or both are 
floating-point values. 


Integer division is the operation in which two values are divided and both are integers; the 
result contains no fractional part. 


The remainder operator is the percent sign; when it is used with two integers, the result is an 
integer with the value of the remainder after division takes place. 


The modulus operator, sometimes abbreviated as mod, is an alternate name for the remainder 
operator. 


Operator precedence is the rules for the order in which parts of a mathematical expression 
are evaluated. 


Type conversion is the process of converting one data type to another. 
A unifying type is a single data type to which all operands in an expression are converted. 
An implicit conversion is the automatic transformation of one data type to another. 


Promotion is an implicit conversion. 









Type casting forces a value of one data type to be used as a value of another type. 


A cast operator performs an explicit type conversion; it is created by placing the desired 
result type in parentheses before the expression to be converted. 


An explicit conversion is the data type transformation caused using a cast operator. 


The unary cast operator is a more complete name for the cast operator that performs explicit 
conversions. 


A unary operator uses only one operand. 
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Variables are named memory locations in which programs store values; the value of a 
variable can change. You must declare all variables you want to use in a program by 
providing a data type and a name. Java provides for eight primitive types of data: boolean, 
byte, char, double, float, int, long, and short. A named constant is a memory location 
that holds a value that can never be changed; it is preceded by the keyword final. 
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A variable of type int can hold any whole number value from —2,147,483,648 to 
+2,147,483,647. The types byte, short, and long are all variations of the integer type. 


A boolean type variable can hold a true or false value. Java supports six relational 
operators: >, <, ==, >=, <=, and !=. 





A floating-point number contains decimal positions. Java supports two floating-point data 
types: float and double. 


You use the char data type to hold any single character. You type constant character 
values in single quotation marks. You type String constants that store more than one 
character between double quotation marks. You can store some characters using an 
escape sequence, which always begins with a backslash. 


You can use the Scanner class and the System. in object to accept user input from the 
keyboard. Several methods are available to convert input to usable data, including 
nextDouble(), nextIntQ, and nextLine(Q). 


You can accept input using the JOptionPane class. The showInputDialog() method 
returns a String, which must be converted to a number using a type-wrapper class before 
you can use it as a numeric value. 


There are five standard arithmetic operators: +, -, *, /, and %. Operator precedence is the 
order in which parts of a mathematical expression are evaluated. Multiplication, division, 
and remainder always take place prior to addition or subtraction in an expression. Right 
and left parentheses can be added within an expression when exceptions to this rule are 
required. When multiple pairs of parentheses are added, the innermost expression 
surrounded by parentheses is evaluated first. 


When you perform mathematical operations on unlike types, Java implicitly converts the 
variables to a unifying type. You can explicitly override the unifying type imposed by Java 
by performing a type cast. 








1. When data cannot be changed after a class is compiled, the data is 





a. constant c. volatile 
b. variable d. mutable 
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2. Which of the following is not a primitive data type in Java? 





a. boolean c. int 
b. byte d. sector 
110 3. Which of the following elements is not required in a variable declaration? 
a. a type c. an assigned value 
b. an identifier d. a semicolon 





4, The assignment operator in Java is 
a = Ci. 3= 
b. == 

5. Assuming you have declared shoeSize to be a variable of type int, which of the 
following is a valid assignment statement in Java? 
a. shoeSize =9; c. shoeSize='9'; 
b. shoeSize =9.5; d. shoeSize = "nine"; 

6. Which of the following data types can store a value in the least amount of memory? 


a. short c. int 
b. long d. byte 


7. A boolean variable can hold 





any character 
any whole number 
any decimal number 


ao F P 


the value true or false 


8. The value 137.68 can be held by a variable of type 





a int 

b. float 

c. double 

d. Two of the preceding answers are correct. 







9. An escape sequence always begins with a(n) 





ae c. backslash 
b. forward slash d. equal sign 
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10. Which Java statement produces the following output? 











w 

XyZ 

a. System.out.printInC"wxyz"); 

b. System.out.printInC"w" + "xyz"); 111 
c. System.out.printinC"w\nxyz") ; 

d. System.out.printInC"w\nx\ny\nz") ; 


11. The remainder operator 


a. is represented by a forward slash 
b. must follow a division operation 
c. provides the quotient of integer division 
d. is none of the above 
12. According to the rules of operator precedence, when division occurs in the same 
arithmetic statement as _________,, the division operation always takes place 
first. 
multiplication 


a 

b. remainder 
c. subtraction 
d 


Answers a and b are correct. 





13. The “equal to” relational operator is 
a = c l= 
b. == d. !! 

14. When you perform arithmetic with values of diverse types, Java 


issues an error message 
implicitly converts the values to a unifying type 












a 

b 

c. requires you to explicitly convert the values to a unifying type 
d. implicitly converts the values to the type of the first operand 


15. If you attempt to add a float, an int, and a byte, the result will be 





a(n) 
a. float c. byte 
b. int d. error message 
16. You usea to explicitly override an implicit type. 
a. mistake c. format 
b. type cast d. type set 
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17. In Java, what is the value of 3 + 7 * 4 + 2? 
a. 21 
b. 33 


18. Which assignment is correct in Java? 
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a. int value = (float) 4.5; 
b. float value = 4 (double); 


19. Which assignment is correct in Java? 
a. double money = 12; 
b. double money = 12.0; 


20. Which assignment is correct in Java? 


c. 42 

d. 48 

c. double value = 2.12; 

d. char value = 5c; 

c. double money = 12.0d; 

d. All of the above are correct. 


a. char aChar =5.5; 

b. char aChar ="W"; 

c. char aChar = '*'; 

d. Two of the preceding answers are correct. 
Exercises 


=) Programming Exercises 


1. What is the numeric value of each of the following expressions as evaluated by Java? 


a 34+7*2 
b. 18/3+4 
c 9/3+4+12/4 
d. 15/2 

e. 14/3 

f, 29/10 
g. 14% 2 
5<8 
4<=9 
Pas 

12 >= 12 
34+4== 









eo aoe 


h. 15%2 

ip 31% 7 

j. 6%441 

k. (64+6)*3 
l 25 /(3 +2) 
m. 13%15 


What is the value of each of the following Boolean expressions? 


fi 7<9-2 
g. o!=5 

h. 15!=3%*5 
i, 9!=-9 


j. 34+5*2==16 
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3. Choose the best data type for each of the following so that any reasonable value is 
accommodated but no memory storage is wasted. Give an example of a typical value 
that would be held by the variable, and explain why you chose the type you did. 








a. the number of siblings you have f. one player’s score in a Scrabble game 

b. your final grade in this class g. one team’s score in a Major League 113 
c. the population of Earth Baseball game 

d. the population of a U.S. county h. the year an historical event occurred 

e. the number of passengers on a bus i, the number of legs on an animal 


4. a. Write a Java class that declares a named constant that holds the number of feet in 
a mile: 5,280. Also declare a variable to represent the distance in miles between 
your house and your uncle’s house. Assign an appropriate value to the variable— 
for example, 8.5. Compute and display the distance to your uncle’s house in both 
miles and feet. Display explanatory text with the values—for example, The 
distance to my uncle's house is 8.5 miles or 44880.0 feet. Save the class as 
MilesToFeet.java. 


b. Convert the MilesToFeet class to an interactive application. Instead of assigning 
a value to the distance, accept the value from the user as input. Save the revised 
class as MilesToFeetInteractive.java. 


5. a. Write a Java class that declares a named constant that represents next year’s 
anticipated 10 percent increase in sales for each division of a company. (You can 
represent 10 percent as 0.10.) Also declare variables to represent this year’s sales 
total in dollars for the North and South divisions. Assign appropriate values to 
the variables—for example, 4000 and 5500. Compute and display, with 
explanatory text, next year’s projected sales for each division. Save the class as 
ProjectedSales.java. 


b. Convert the ProjectedSales class to an interactive application. Instead of 
assigning values to the North and South current year sales variables, accept them 
from the user as input. Save the revised class as ProjectedSalesInteractive.java. 


6. a. Write a class that declares a variable named inches that holds a length in inches, 
and assign a value. Display the value in feet and inches; for example, 86 inches 
becomes 7 feet and 2 inches. Be sure to use a named constant where appropriate. 
Save the class as InchesToFeet.java. 









b. Write an interactive version of the InchesToFeet class that accepts the inches 
value from a user. Save the class as InchesToFeetInteractive.java. 


7. Write a class that declares variables to hold your three initials. Display the three 
initials with a period following each one, as in J.M.F. Save the class as Initials.java. 
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8. Meadowdale Dairy Farm sells organic brown eggs to local customers. They charge 
$3.25 for a dozen eggs, or 45 cents for individual eggs that are not part of a dozen. 
Write a class that prompts a user for the number of eggs in the order and then 
display the amount owed with a full explanation. For example, typical output might 
be, “You ordered 27 eggs. That’s 2 dozen at $3.25 per dozen and 3 loose eggs at 45.0 

114 cents each for a total of $7.85.” Save the class as Eggs.java. 





9. The Happy Yappy Kennel boards dogs at a cost of 50 cents per pound per day. Write 
a class that accepts a dog’s weight and number of days to be boarded and displays the 
total price for boarding. Save the class as DogBoarding.java. 


10. Write a class that calculates and displays the conversion of an entered number of dollars 
into currency denominations—20s, 10s, 5s, and 1s. Save the class as Dollars.java. 


1l. Write a program that accepts a temperature in Fahrenheit from a user and converts 
it to Celsius by subtracting 32 from the Fahrenheit value and multiplying the result 
by 5/9. Display both values. Save the class as FahrenheitToCelsius.java. 


12. Travel Tickets Company sells tickets for airlines, tours, and other travel-related 
services. Because ticket agents frequently mistype long ticket numbers, Travel 
Tickets has asked you to write an application that indicates invalid ticket number 
entries. The class prompts a ticket agent to enter a six-digit ticket number. Ticket 
numbers are designed so that if you drop the last digit of the number, then divide the 
number by 7, the remainder of the division will be identical to the last dropped digit. 
This process is illustrated in the following example: 


Step 1 Enter the ticket number; for example, 123454. 
Step 2 Remove the last digit, leaving 12345. 
Step 3 Determine the remainder when the ticket number is divided by 7. In this 


case, 12345 divided by 7 leaves a remainder of 4. 


Step 4 Assign the Boolean value of the comparison between the remainder and 
the digit dropped from the ticket number. 


Step 5 Display the result—true or false—in a message box. 








Accept the ticket number from the agent and verify whether it is a valid number. 
Test the application with the following ticket numbers: 


e 123454; the comparison should evaluate to true 
e 147103; the comparison should evaluate to true 
e 154123; the comparison should evaluate to false 


Save the program as TicketNumber.java. 
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Exercises 


Ws Debugging Exercises 


1. Each of the following files in the Chapter02 folder of your downloadable student files 
has syntax and/or logic errors. In each case, determine the problem and fix the 
application. After you correct the errors, save each file using the same filename 








115 
preceded with Fix. For example, DebugTwol java will become FixDebugTwol java. 
a. DebugTwol.java c. DebugTwo3,java 
b. DebugTwo2.java d. DebugTwo4.java 


When you change a filename, remember to change every instance of the class name within the file so that it 
GY matches the new filename. In Java, the filename and class name must always match. 


oy, Game Zone 


1. Mad Libs is a children’s game in which the players provide a few words that are then 
incorporated into a silly story. The game helps children understand different parts of 
speech because they are asked to provide specific types of words. For example, you 
might ask a child for a noun, another noun, an adjective, and a past-tense verb. The 
child might reply with such answers as table, book, silly, and studied. The newly 
created Mad Lib might be: 


Mary had a little table 

Its book was silly as snow 

And everywhere that Mary studied 
The table was sure to go. 


Create a Mad Libs program that asks the user to provide at least four or five words, 
and then create and display a short story or nursery rhyme that uses them. Save the 
file as MadLib.java. 


2. Inthe “Game Zone” section in Chapter 1, you learned how to obtain a random 
number. For example, the following statement generates a random number between 
the constants MIN and MAX inclusive and assigns it to a variable named random: 


random = 1 + Cint)(Math.random() * MAX); 












Write a program that selects a random number between 1 and 5 and asks the 
user to guess the number. Display a message that indicates the difference 
between the random number and the user’s guess. Display another message 

that displays the random number and the Boolean value true or false depending 
on whether the user’s guess equals the random number. Save the file as 
RandomGuessMatch.java. 
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Q Case Problems 


Carly’s Catering provides meals for parties and special events. Write a program that 
116 prompts the user for the number of guests attending an event and then computes the 
total price, which is $35 per person. Display the company motto with the border that 
you created in the CarlysMotto2 class in Chapter 1, and then display the number of 
guests, price per guest, and total price. Also display a message that indicates true 
or false depending on whether the job is classified as a large event—an event with 
50 or more guests. Save the file as CarlysEventPrice.java. 





2. Sammy’s Seashore Supplies rents beach equipment such as kayaks, canoes, beach 
chairs, and umbrellas to tourists. Write a program that prompts the user for the 
number of minutes he rented a piece of sports equipment. Compute the rental 
cost as $40 per hour plus $1 per additional minute. (You might have surmised 
already that this rate has a logical flaw, but for now, calculate rates as described 
here. You can fix the problem after you read the chapter on decision making.) 
Display Sammy’s motto with the border that you created in the SammysMotto2 
class in Chapter 1. Then display the hours, minutes, and total price. Save the 
file as SammysRentalPrice.java. 
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Using Methods, 
Classes, and Objects 


In this chapter, you will: 


Learn about method calls and placement 


(©) 


Identify the parts of a method 


(©) 


Add parameters to methods 


(©) 


Create methods that return values 


(©) 


Learn about classes and objects 


(©) 


Create a class 


(©) 


Create instance methods in a class 


(©) 


Declare objects and use their methods 


(©) 


Create constructors 


(©) 


Appreciate classes as data types 


(©) 





Unless noted otherwise, all images are © 2014 Cengage Learning 
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CHAPTER 3 Using Methods, Classes, and Objects 


Understanding Method Calls and Placement 


A method is a program module that contains a series of statements that carry out a task. You 

have already seen Java classes that contain a main() method, which executes automatically 

when you run a program. A program’s main() method can execute additional methods, and 
118 those methods can execute others. Any class can contain an unlimited number of methods, 
and each method can be called an unlimited number of times. 





To execute a method, you invoke or call it. In other words, a calling method makes a 
method call, and the method call invokes a called method. The calling method is also known 
as a Client method because a called method provides a service for its client. 


Consider the simple First class that you saw in Chapter 1; it displayed a single line of 
output, “First Java application.” Suppose that you want to add three lines of output to 
this application to display your company’s name and address. One approach would be to 
simply add three new print1n(Q) statements, as shown in the shaded statements in 
Figure 3-1. 


public class First 
{ 
public static void main(String[] args) 


{ 


System.out.printInC"XYZ Company") ; 


System.out.printIn('"8900 U.S. Hwy 14"); 
System.out.printInC"Crystal Lake, IL 60014"); 
System.out.printInC"First Java application") ; 





Figure 3-1 The First class 


Instead of adding the three printIn() statements to the application in Figure 3-1, 

you might prefer to call a method that executes the three statements. Then the program 
would look like the one in Figure 3-2. The shaded line contains the call to the 
nameAndAddress() method. 


public class First 
{ 
public static void main(String[] args) 


{ 


nameAndAddressQ) ; 
System.out.printInC"First Java application") ; 


i 





Figure 3-2 The First class with a call to the nameAndAddress() method 
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Understanding Method Calls and Placement D0 


There are two major advantages to creating a separate method to display the three address lines. 
First, the main© method remains short and easy to follow because main() contains just one 
statement to call the method, rather than three separate print1n() statements to perform the 
work of the method. What is more important is that a method is easily reusable. After you create 
the name and address method, you can use it in any application that needs the company’s name 
and address. In other words, you do the work once, and then you can use the method many times. 119 








Besides adding a call to the method in the First class, you must actually write the method. You 
place a method within a class, but it must be outside of any other methods. In other words, 
you cannot place a method within another method. Figure 3-3 shows the two locations where 
you can place additional methods within the First class—within the curly braces of the class, but 
outside of (either before or after) any other methods. Methods can never overlap. 


The order of methods in a class has no bearing on the order in which the methods are called 
or executed. No matter where you place it, the main@ method is always executed first in any 
Java application, and it might call any other methods in any order and any number of times. 
The order in which you call methods, and not their physical placement, is what makes a 
difference in how an application executes. 


public class First 
{ 
// You can place additional methods here, before main() 
public static void main(String[] args) 
{ 
nameAndAddress() ; 
System.out.printInC"First Java application"); 


} 


// You can place additional methods here, after mainQ) 





Figure 3-3 Placement of methods within a class 


A mainQ method executes automatically when you run a program, but other methods do not 

execute simply because you place them within a class—they must be called. A class might contain 
methods that are never called from a particular application, just as some electronic devices might 
contain features you never use. For example, you might use a DVR to play movies but never to 
record TV programs, or you might use your microwave oven for popcorn but never to defrost. 


Figure 3-4 shows the First class with two methods: the mainQ method and the 
nameAndAddress() method placed after mainQ. Figure 3-5 shows the output from the 
execution of the First class in Figure 3-4. When the program executes, the main() method 
first calls the nameAndAddress() method, which displays three lines of output. Then mainQ 
displays the phrase “First Java application”. 


programmers call abstraction. Consider abstract art, in which the artist tries to capture the essence of an 
object without focusing on the details. Similarly, when programmers employ abstraction, they use a general 
method name in a module rather than list all the detailed activities that will be carried out by the method. 


Q Using a method name to contain or encapsulate a series of statements is an example of the feature that 
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public class First 
The main) method in | t 


this class contains two public static void main(String[] args) 
tatements. The fi { 
one sa calito he naneAndAddress(); 
120 nameAndAddress() System.out.printIn("First Java application") ; 
method. 





public static void nameAndAddress() 

{ 
System.out.printInC"XYZ Company") ; 
System.out.printi1n("8900 U.S. Hwy 14"); 
System.out.printInC"Crystal Lake, IL 60014"); 

} 








Figure 3-4 First class with main() calling nameAndAddress() 





Crystal Lake, IL 
First Java application 


C:\Java>_ 








Figure 3-5 Output of the First application, including the nameAndAddress() method 


@®@ 
= Watch the video Methods. 


Understanding Method Calls and Placement 


1. Any class can contain an unlimited number of methods. 
During one program execution, a method might be called any number of times. 
3. A method is usually written within another method. 
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Understanding Method Construction D0 


Understanding Method Construction 


Every method must include the two parts featured in Figure 3-6: 


e A method header—A method’s header provides information about how other methods 


can interact with it. A method header is also called a declaration. 
121 








e A method body between a pair of curly braces—The method body contains the 
statements that carry out the work of the method. A method’s body is called its 
implementation. Technically, a method is not required to contain any statements in its 
body, but you usually would have no reason to create an empty method in a class. 
Sometimes, while developing a program, the programmer creates an empty method as a 
placeholder and fills in the implementation later. An empty method is called a stub. 





public class First 


{ 


public static void main(String[] args) 


{ 
Method nameAndAddress() ; 
headers } System.out.printInC"First Java application"); 


public static void nameAndAddress() 





System.out.printInC"XYZ Company") ; 
System.out.printIn("8900 U.S. Hwy 14"); 
System.out.printInC"Crystal Lake, IL 60014"); 








Figure 3-6 The headers and bodies of the methods in the First class 


The method header is the first line of a method. It contains the following: 
e Optional access specifiers 

e A return type 

e An identifier 

e Parentheses 


The next few figures compare these parts of a method header for the main() method and the 
nameAndAddress() method in the First class. 


Access Specifiers 


Figure 3-7 highlights the optional access specifiers for the two methods in the First class. 
The access specifier for a Java method can be any of the following modifiers: public, private, 
protected, or, if left unspecified, package by default. Most often, methods are given public 
access; this book will cover the other modifiers later. Endowing a method with public access 
means that any other class can use it, not just the class in which the method resides. 
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CHAPTER 3 Using Methods, Classes, and Objects 


The main O method in an application The nameAndAddress () method 
must specify public access. is not required to specify public 





access. However, if access is 
public, the method can be used 
public static void main(String[] args) by other, outside classes. 
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public static void nameAndAddress() 


The static modifier means that 


these methods do not require an 
object to be created. 











Figure 3-7 Access specifiers for two methods 


You first learned the term access specifier in Chapter 1. Access specifiers are sometimes called 
Y access modifiers. 


In addition, any method that can be used without instantiating an object requires the keyword 
modifier static. The main() method in an application must use the keyword static, but 
other methods, like nameAndAddress(), can use it too. You will learn about nonstatic 
methods later in this chapter. 


Return Type 


Figure 3-8 features the return types for the main() and nameAndAddress() methods in the 
First class. A return type describes the type of data the method sends back to its calling 
method. Not all methods return a value to their calling methods; a method that returns no 
data has a return type of void. The main() method in an application must have a return type 
of void; in this example, nameAndAddress() also has a void return type. Other methods that 
you will see later in this chapter have different return types. The phrases void method and 
method of type void both refer to a method that has a void return type. 


The main() method in an application must 
have a void return type. 


public static void main(String[] args) 


public static void nameAndAddress() 


The nameAndAddress() method does not send any information 
back to the method that calls it, so its return type is void. Later in 
this chapter you will write methods with other return types. 








Figure 3-8 Return types for two methods 
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Understanding Method Construction D0 


Method Name 


Figure 3-9 highlights the names of the two methods in the First class. A method’s name can 

be any legal identifier. That is, like identifiers for classes and variables, a method’s identifier 

must be one word with no embedded spaces, and cannot be a Java keyword. The method that 
executes first when you run an application must be named mainQ), but you have a lot of 123 
leeway in naming other methods that you create within a class. Technically, you could even 
name another method main() as long as you did not include String[] within the 
parentheses, but doing so would be confusing and is not recommended. 











public static void main(String[] args) 


Other methods you write in a class 
can have any legal identifier. 


The method that executes first when you run 
an application must be named main(). 





public static void nameAndAddress() 





Figure 3-9 Identifiers for two methods 


Parentheses 


As Figure 3-10 shows, every method header contains a set of parentheses that follow 

the identifier. The parentheses might contain data to be sent to the method. For example, 
when you write a main() method in a class, the parentheses in its header surround 
String[] args. The nameAndAddress() method in the First class requires no outside data, so 
its parentheses are empty. Later in this chapter, you will see several methods that accept data. 





The main() method in an application must contain String[] 


and an identifier (args is traditional) within its parentheses. 





public static void main(String[] args) 


public static void nameAndAddress() 


Other methods you write might accept data 


within their parentheses, but 
nameAndAddress() does not. 








Figure 3-10 Parentheses and their contents for two methods 


The full name of the nameAndAddress() method is First.nameAndAddress(), which 
includes the class name, a dot, and the method name. (The name does not include an 
object because nameAndAddress() is a static method.) A complete name that includes the 
class is a fully qualified identifier. \/hen you use the nameAndAddress() method within its 
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own class, you do not need to use the fully qualified name (although you can); the simple 
method name alone is enough. However, if you want to use the nameAndAddress() method in 
another class, the compiler does not recognize the method unless you use the full name. You 
have used similar syntax (including a class name, dot, and method name) when calling the 
JOptionPane.showMessageDialog() method. 


124 ; ; 
Each of two different classes can have its own method named nameAndAddress(). Such a 


method in the second class would be entirely distinct from the identically named method in 
the first class. You could use both methods in a third class by using their fully qualified 
identifiers. Two classes in an application cannot have the same name. 





family reunion,” but outside the family people need to use a surname as well, as in “the Anderson family 
reunion.” Similarly, within a class a method name alone is sufficient, but outside the class you need to use the 
fully qualified name. 


Understanding Method Construction 


Q Think of the class name as the family name. Within your own family, you might refer to an activity as “the 


1. A method header Is also called an implementation. 
2. Whena method is declared with public access, methods in other classes can call it. 
3. Not all methods return a value, but every method requires a return type. 


"uolje}UaWe|duI 
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<a You Do It 


Creating a static Method That Requires No Arguments and Returns No Values 


Paradise Day Spa provides many personal services such as haircuts, manicures, and 
facials. In this section, you create a new class named ParadiseInfo, which contains 
a main() method that calls a displayInfo() method. 


1. Open anew document in your text editor, and type the following shell for the class: 


public class ParadiseInfo 
{ 
} 


(continues) 
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(continued) 


2. Between the curly braces of the class, indent a few spaces and create the 
shell for the main@ method: 


public static void main(String[] args) 125 
{ 
} 


3. Between the braces of the main@ method, insert a call to the displayInfoO method: 
displayInfoQ; 


4. Place the displayInfo() method outside the main method, just before the 
closing curly brace for the ParadiseInfo Class: 








public static void displayInfoO 

{ 
System.out.printIn("Paradise Day Spa wants to pamper you.") ; 
System.out.printIn(C"We will make you look good.") ; 

} 


5. Save the file as Paradiselnfo.java. 
6. Compile the class, and then execute it. The output should look like Figure 3-11. 








C:\Java>java ParadiselInfo 
Paradise Day Spa wants to pamper you. 
We will make you look good. 


C2\Java>_ 





Figure 3-11 Output of the ParadiseInfo application 
Calling a static Method from Another Class 


Next, you see how to call the displayInfoQ method from a method within another class. 


1. Open anew document in your text editor, and then enter the following class in 
which the main® method calls the displayInfo( method that resides in the 
ParadiselInfo Class: 


public class TestInfo 
{ 
public static void main(String[] args) 
{ 
System.out.printIn(''Calling method from another class:"); 
ParadiseInfo.displayInfoQ ; 


(continues) 
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(continued) 


2. Save the file as TestInfo.java in the same folder as the ParadiseInfo Class. 
If the files are not saved in the same folder and you try to compile the calling 
class, your compiler issues the error message “cannot find symbol”; the symbol 


126 named is the missing class you tried to call. 





3. Compile the application and execute it. Your output should look like Figure 3-12. 
The TestInfo class does not contain the displayInfo() method; it uses the 
method from the ParadiseInfo Class. It’s important that the displayInfoQ 
method is public. If you had omitted the keyword public from the definition 
of the displayInfoQ method in the ParadiseInfo class, then the TestInfo 
class would not have been able to use it. 





Fe 
fay Command Prompt a. 


C:\Java>java TestInfo 
Calling method from another class: 
Paradise Day Spa wants to pamper you. 


We will make you look good. 


aE UT. Ba 











Figure 3-12 Output of the TestInfo application 
Examining the Details of a Prewritten static Method 


Recall that in Chapter 2, you used the JOptionPane class to create statements 
like the following: 


JOptionPane.showMessageDialog 
(null, "Every bill is due in 


+ creditDays + " days"); 


In the next steps, you examine the Java API documentation for the showMessageDialog() 
method so that you can better understand how prewritten methods are similar to ones 
that you write. 


1. Using a Web browser, go to the Java Web site and select Java APIs and Java SE 7. 
2. In the alphabetical list of classes, find the JOptionPane class and select it. 


3. Scroll through the class documentation until you find the Method Summary. 
Then, find the first listed version of the showMessageDialog() method. To the left, 
notice that the method is defined as a static void method, just like the mainQ and 
displayInfo() methods discussed earlier in this “You Do It” section. You can use 
the static showMessageDialog() method in your classes by using its class name, 
a dot, and the method name, in the same way that you used the ParadiseInfo 
static displayInfo() method in the outside class named TestInfo. 
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Adding Parameters to Methods 


Some methods require that data be sent to them when they are called. Data items you use in a 

call to a method are called arguments. When the method receives the data items, they are 

called parameters. Methods that receive data are flexible because they can produce different 

results depending on what data they receive. 127 








As a real-life example, when you make a restaurant reservation, you do not need to employ a 
different method for every date of the year at every possible time of day. Rather, you can 
supply the date and time as information to the person who carries out the method. The 
method, recording the reservation, is then carried out in the same manner, no matter what 
date and time are supplied. 


In a program, if you design a method to square numeric values, it makes sense to design a 
square() method that you can supply with an argument that represents the value to be 
squared, rather than having to develop a square1() method (that squares the value 1), a 
square2() method (that squares the value 2), and so on. To call a square() method that 
takes an argument, you might write a statement like square(17) ; or square(86) ;. Similarly, 
any time it is called, the printInQ) method can receive any one of an infinite number of 
arguments—for example, “Hello”, “Goodbye”, or any other String. No matter what message 
is sent to printInQ, the message is displayed correctly. If the printIn@) method could not 
accept arguments, it would not be practical to use. 


An important principle of object-oriented programming is implementation hiding, which 
describes the encapsulation of method details. For example, when you make a real-life 
restaurant reservation, you do not need to know how the reservation is actually recorded 
at the restaurant—perhaps it is written in a book, marked on a large chalkboard, or 
entered into a computerized database. The implementation details don’t concern you as 
a client, and if the restaurant changes its methods from one year to the next, the change 
does not affect your use of the reservation method—you still call and provide your 
name, a date, and a time. 


With well-written object-oriented programming methods, using implementation hiding 
means that a method that calls another must know the name of the called method and 
what type of information to send. (Usually, you also want to know about any data returned 
by the method; you will learn about returned data later in this chapter.) However, the 
client does not need to know how the method works internally. In other words, the calling 
method needs to understand only the interface to the called method. The interface is the 
only part of a method that the method’s client sees or with which it interacts. In addition, if 
you substitute a new or revised method implementation, as long as the interface to the 
method does not change, you won’t need to make any changes in any methods that call the 
altered method. 


devices are black boxes—that is, you can use them without understanding how they work. For 
example, most of us use telephones, television sets, and automobiles without understanding much 
about their internal mechanisms. 


Q Hidden implementation methods are often referred to as existing in a black box. Many everyday 
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Creating a Method That Receives a Single Parameter 


When you write the method declaration for a method that can receive a parameter, you begin 

by defining the same elements as you do for methods that do not accept parameters— 

optional access specifiers, the return type for the method, and the method name. In addition, 
128 you must include the following items within the method declaration parentheses: 





e The parameter type 

e A local name for the parameter 

For example, the declaration for a public method named predictRaise() that accepts a 
person’s annual salary and computes the value of a 10 percent raise could be written as follows: 
public static void predictRaise(double salary) 

You can think of the parentheses in a method declaration as a funnel into the method— 
parameters listed there contain data that is “dropped into” the method. A parameter accepted 


by a method can be any data type, including the primitive types, such as int, double, and 
char; it also can be a class type such as String or PrintStream. 


In the method header for predictRaise(), the parameter double salary within the 
parentheses indicates that the method will receive a value of type double, and that within the 
method, the passed value will be known as salary. Figure 3-13 shows a complete method. 


Parameter data Parameter 
type identifier 


public static void predictRaise(double salary) 


{ 


double newSalary; 


final double RAISE_RATE= 1.10; 
newSalary = salary * RAISE_RATE; 
System.out.printin("Current salary: " + 


salary +" After raise: " + 
newSalary) ; 





Figure 3-13. The predictRaise() method 


The predictRaise() method is a void method because it does not need to return a value to 
any other method that uses it—its only function is to receive the salary value, multiply it by 
the RAISE_RATE constant (1.10, which results in a 10 percent salary increase), and then display 
the result. 


You can call the predictRaise() method by using either a constant value or a variable as an 
argument. Thus, both predictRaise(472.25); and predictRaise(mySalary); invoke the 
predictRaise() method correctly, assuming that mySalary is declared as a double variable 
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and is assigned an appropriate value in the calling method. You can call the predictRaise() 
method any number of times, with a different constant or variable argument each time. Each of 
these arguments becomes known as salary within the method. The identifier salary 
represents a variable that holds a copy of the value of any doub1e value passed into the method. 


It is interesting to note that if the value used as an argument in the method call to 
predictRaise() is a variable, it might possess the same identifier as salary or a 
different one, such as startingWage. For example, the code in Figure 3-14 shows three 
calls to the predictRaise() method, and Figure 3-15 shows the output. One call uses a 
constant, 400.00. The other two use variables—one with the same name as salary and 
the other with a different name, startingWage. The identifier salary in the mainQ) 
method refers to a different memory location than the one in the predictRaise() 
method. The parameter salary is simply a placeholder while it is being used within the 
predictRaise() method, no matter what name its value “goes by” in the calling method. 
The parameter salary is a local variable to the predictRaise() method; that is, it is 
known only within the boundaries of the method. The variable and constant declared 
within the method are also local to the method. 


129 











public class DemoRaise 
public static void main(String[] args) 


double salary = 200.00; 
double startingWage = 800.00; 
System.out.printInC"Demonstrating some raises"); 
predictRaise(400.00); 
predictRaise(salary) ; 
predictRaise(startingWage) ; 


The predictRaise() method 
is called three times using three 





different arguments. 


} 


public static void predictRaise(double salary) 





double newSalary; The parameter salary 
final double RAISE_RATE= 1.10; receives a copy of the 
newSalary = salary * RAISE_RATE; value in each argument that 
System.out.printInC"Current salary: " + is passed. 


salary + After raise: + 


newSalary) ; 








Figure 3-14 The DemoRaise class with a main() method that uses the predictRaise() 
method three times 


predictRaise() method in Figure 3-14, you could also make it constant by declaring the method 
header as public static void predictRaise(final double salary). There would be no 
difference in the program's execution, but declaring a parameter as final means it cannot be altered 
within the method. Someone reading your program would be able to see that the parameter is not intended 
to change. 


Q Recall that the final modifier makes RAISE_RATE constant. Because salary is not altered within the 
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a 





fa" Command Prompt 


=: 446. 66080000000006 
=: 226. 68680808000063 


Current salary: $00.8 After raise: 886.66600000600001 


C:z\Java>_ 








Figure 3-15 Output of the DemoRaise application 


Each time the predictRaise() method in Figure 3-14 executes, a salary variable is 
redeclared—that is, a new memory location large enough to hold a doub1e is set up and 
named salary. Within the predictRaise() method, salary holds a copy of whatever value 
is passed into the method by the main() method. When the predictRaise() method ends at 
the closing curly brace, the local salary variable ceases to exist. That is, if you change the 
value of salary after you have used it in the calculation within predictRaise(), it affects 
nothing else. The memory location that holds salary is released at the end of the method, 
and any changes to its value within the method do not affect any value in the calling method. 
In particular, don’t think there would be any change in the variable named salary in the 
main() method; that variable, even though it has the same name as the locally declared 
parameter in the method, is a different variable with its own memory address and is totally 
different from the one in the predictRaise() method. When a variable ceases to exist at the 
end of a method, programmers say the variable “goes out of scope.” A variable’s scope is 
the part of a program in which a variable exists and can be accessed using its unqualified 


name. The next chapter discusses scope in greater detail. 


Creating a Method That Requires Multiple Parameters 


A method can require more than one parameter. You can pass multiple arguments to a 
method by listing the arguments within the call to the method and separating them with 
commas. For example, rather than creating a predictRaise() method that adds a 10 percent 
raise to every person’s salary, you might prefer to create a method to which you can pass two 
values—the salary to be raised as well as a percentage figure by which to raise it. Figure 3-16 


shows a method that uses two such parameters. 





public static void predictRaiseUsingRate(double salary, double rate) 


{ 

double newAmount; 

newAmount = salary * (1 + rate); 

System.out.printInC"With raise, new salary is " + newAmount); 
} 


Figure 3-16 The predictRaiseUsingRate() method that accepts two parameters 
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In Figure 3-16, two parameters (double salary and double rate) appear within the 
parentheses in the method header. A comma separates each parameter, and each 
parameter requires its own declared type (in this case, both are double) as well as its 
own identifier. Note that a declaration for a method that receives two or more 
parameters must list the type for each parameter separately, even if the parameters have 
the same type. When values are passed to the method in a statement such as the 131 
following, the first value passed is referenced as salary within the method, and the 
second value passed is referenced as rate: 








predictRaiseUsingRate(mySalary, promisedRate) ; 


Therefore, arguments passed to the method must be passed in the correct order. The call 
predictRaiseUsingRate(200.00, 0.10); results in output representing a 10 percent raise 
based on a $200.00 salary amount (or $220.00), but predictRaiseUsingRate(0.10, 200.00); 
results in output representing a 20,000 percent raise based on a salary of 10 cents (or $20.10). 
If two method parameters are the same type—for example, two doubles—passing arguments 
to a method in the wrong order results in a logical error; that is, the program does compile 
and execute, but it probably produces incorrect results. If a method expects parameters of 
diverse types, passing arguments in the wrong order constitutes a syntax error, and the 
program does not compile. 


You can write a method so that it takes any number of parameters in any order. However, 
when you call a method, the arguments you send to a method must match in order—both in 
number and in type—the parameters listed in the method declaration. A method’s signature 
is the combination of the method name and the number, types, and order of arguments. 

A method call must match the called method’s signature. 


Thus, a method to compute an automobile salesperson’s commission amount might require 
arguments such as an integer dollar value of a car sold, a double percentage commission rate, 
and a character code for the vehicle type. The correct method executes only when three 
arguments of the correct types are sent in the correct order. Figure 3-17 shows a class 
containing a three-parameter method and a main() method that calls it twice, once using 
variable arguments and again using constant arguments. Figure 3-18 shows the output of the 
application. 


public class ComputeCommission 
{ 
public static void main(String[] args) 


af 


char vType = 'S'; 


int value = 23000; 

double commRate = 0.08; 
computeCommission(value, commRate, vType); 
computeCommission(40000, 0.10, 'L"); 





Figure 3-17 The ComputeCommission class (continues) 
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(continued) 


public static void computeCommission(int value, 
double rate, char vehicle) 
{ 
double commission; 
132 commission = value * rate; 
System.out.printinC"\nThe + vehicle + 
" type vehicle is worth $" + value); 
System.out.printiInC"With " + Crate * 100) + 
"% commission rate, the commission is $" + 
commission); 








Figure 3-17 The ComputeCommission class 





i 


fa Command Prompt r* a) 


C:\Java>java ComputeCommission 


The § type vehicle is worth $230600 
With 8.0% commission rate. the commission is $1846.06 


The L type vehicle is worth $460000 
With 16.0% commission rate. the commission is $4000.6 


A EUr. @ 











Figure 3-18 Output of the ComputeCommission application 


Ws The arguments in a method call are often referred to as actual parameters. The variables 
Oj in the method declaration that accept the values from the actual parameters are formal 
oy, parameters. 


When you look at Java applications, you might see methods that appear to be callable in multiple 
ways. For example, you can use System.out.print1n() with no arguments to display a blank 
line, or with a String argument to display the String. You can use the method with different 
argument lists only because multiple versions of the method have been written, each taking a specific 
set of arguments. The ability to execute different method implementations by altering the argument 
used with the method name is known as method overloading, a concept you will learn about in the 
next chapter. 
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Adding Parameters to Methods 


1. Aclass can contain any number of methods, and each method can be called any 133 
number of times. 








2. Arguments are used in method calls; they are passed to parameters in method 
headers. 


3. A method header always contains a return type, an identifier, and a parameter list 
within parentheses. 
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Creating Methods That Return Values 
A method ends when any of the following events takes place: 


e The method completes all of its statements. You have seen methods like this in the last 
section. 


e The method throws an exception. Exceptions are errors; you will learn about them in the 
chapter Exception Handling. 


e The method reaches a return statement. A return statement causes a method to end and 
the program’s logic to return to the calling method. Also, a return statement frequently 
sends a value back to the calling method. 


The return type for a method can be any type used in Java, which includes the primitive 
types int, double, char, and so on, as well as class types (including class types you 
create). Of course, a method can also return nothing, in which case the return type 

is void. 


A method’s return type is known more succinctly as a method's type. For example, the 
declaration for the nameAndAddress() method shown earlier in Figure 3-4 is written as 
follows: 


public static void nameAndAddress() 
This method returns no value, so it is type void. 


A method that prompts a user for an age and returns the age to the calling method might be 
declared as: 


public static int getAgeQ 


The method returns an int, so it is type int. 
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As another example, a method that returns true or false, depending on whether an 
employee worked overtime hours, might be declared as: 


public static boolean workedOvertime() 
This method returns a Boolean value, so it is type boolean. 


134 The predictRaise() method shown earlier produces output but does not return any value, 
so its return type is void. If you want to create a method to return the new, calculated salary 
value rather than display it, the header would be written as follows: 





public static double predictRaise(double salary) 


Figure 3-19 shows this method. 


public static double predictRaise(double salary) 
{ 

double newAmount; 

final double RAISE = 1.10; 


newAmount = salary * RAISE; 
return newAmount; 





Figure 3-19 The predictRaise() method returning a double 


Notice the shaded return type double that precedes the method name in the 
predictRaise() method header in Figure 3-19. Also notice the shaded declaration of 
newAmount. This double variable is returned in the last shaded statement in the method. 
The return statement causes a value to be sent from a called method back to the calling 
method. In this case, the value stored in newAmount is sent back to any method that calls 
the predictRaise() method. A method’s declared return type must match the type of 
the value used in the return statement; if it does not, the class does not compile. A 
method can return, at most, one value. The value can be a primitive data type, such as 
int, char, or double, or it can be a type that represents a class. (You will learn more 
about class types later in this chapter.) The returned value can even be a named or 
unnamed constant, as long as it is the correct data type or can be automatically 
converted to the correct data type. For example, a method with a double return type 
could include the statement return 1; or return 1.0;. 


type. You can place a return statement in a void method that is simply the word return followed by a 
semicolon. However, most Java programmers do not include a return statement in a method when 
nothing is returned. 


Q All methods except void methods require a return statement that returns a value of the appropriate 


You cannot place any statements after a method’s return statement. Such statements are 
unreachable statements because the logical flow leaves the method at the return statement. 
An unreachable statement can never execute, and it causes a compiler error. Unreachable 
statements are also called dead code. 
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not recommended because it can lead to errors that are difficult to detect. However, no other statements 
can be placed after the last return clause in a method. You will learn about decision making in the chapter 
Making Decisions. 


Q A method can contain multiple return clauses if they are embedded in a decision, although this practice is 


If a method returns a value, then when you call the method, you normally use the returned 135 
value, although you are not required to do so. For example, when you invoke the 
predictRaise() method, you might want to assign the returned value (also called the method’s 
value) to a double variable named myNewSalary, as in the following statement: 








myNewSalary = predictRaise(mySalary) ; 


The predictRaise() method returns a double, so it is appropriate to assign the method’s 
returned value to a double variable. 


Alternatively, you can choose to use a method’s returned value directly, without storing it in any 
variable. When you use a method’s value, you use it in the same way you would use any variable of 
the same type. For example, you can display a return value in a statement such as the following: 


System.out.printInC"New salary is " + predictRaise(mySalary)); 


In the preceding statement, the call to the predictRaise() method is made from within the 
printIn© method call. Because predictRaise( returns a double, you can use the method call 
in the same way that you would use any simple double value. As another example, you can 
perform arithmetic with a method’s return value, as in the following statement: 


double spendingMoney = predictRaise(mySalary) - expenses; 


Chaining Method Calls 


Any method might call any number of other methods. For example, a main() method might call 
a predictRaise() method, and the predictRaise() method might call a calculateBonus() 
method, as shown in the shaded statement in Figure 3-20. 


public static double predictRaise(double salary) 
{ 

double newAmount; 

double bonusAmount; 

final double RAISE = 1.10; 


newAmount = salary * RAISE; 

bonusAmount = calculateBonus(newAmount) ; 
newAmount = newAmount + bonusAmount; 
return newAmount; 





Figure 3-20 The predictRaise() method calling the calculateBonus() method 


Looking at the call to the calculateBonus() method from the predictRaise() method, you 
do not know how calculateBonus() works. You only know that the calculateBonus() 
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method accepts a double as a parameter (because newAmount is passed into it) and that it 
must return either a double or a type that can automatically be promoted to a double 
(because the result is stored in bonusAmount). In other words, the method acts as a black box. 


As examples, the calculateBonus() method might look like either of the versions shown in 
136 Figure 3-21. The first version simply adds a $50.00 bonus to a salary parameter. The second 
version calls another method named trickyCalculation() that returns a value added to 
salary. When you read the calculateBonus() method, you don’t know what happens in the 
trickyCalculation() method, and when you read the predictRaise() method that calls 
calculateBonus(), you don’t even necessarily know that trickyCalculation() is called. 





public static double calculateBonus(double salary) 


{ 


final double BONUS_AMT = 50.00; 
salary = salary + BONUS AMT; 
return salary; 


f 


public static double calculateBonus(double salary) 
{ 

salary = salary + trickyCalculationQ); 

return salary; 





Figure 3-21 Two possible versions of the calculateBonus() method 


ee : 
eu Watch the video Methods and Parameters. 





Creating Methods That Return Values 


1. The return type for a method can be any type used in Java, including int, double, 
and void. 


2. Amethod’s declared return type must match the type of the value used in the 
parameter list. 


3. You cannot place a method within another method, but you can call a method from 
within another method. 
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Creating static Methods That Accept Arguments and Return a Value 


In this section, you add a method to the ParadiseInfo class you started in the last 
“You Do It” section. The new method receives two parameters and returns a value. 
The purpose of the method is to accept a minimum price for the current week’s 
featured discount and the percentage discount, and to return the minimum amount 
the customer will save. 


1. Open the Paradiselnfo.java file in your text editor, and then change the class 
name to ParadiseInfo2. Immediately save the file as Paradiselnfo2.java. 


2. As the first line of the file, add the import statement that allows user input: 


import java.util .Scanner; 


3. Add four declarations as the first statements following the opening curly 
brace of the main() method. One holds the minimum price for which a 
discount will be allowed, and another holds the discount rate. The third 
variable is the minimum savings, which is calculated by multiplying the 
minimum price for a discount and the discount rate. The fourth variable is 
a Scanner object to use for keyboard input. 
double price; 
double discount; 


double savings; 
Scanner keyboard = new Scanner (System. in) ; 


Instead of importing the Scanner class to provide console input, you could substitute 
JOptionPane and include program statements that provide GUI input. The input process can 
use other techniques too, such as getting data from a storage device—you will learn about file input 
in the chapter File Input and Output. The concept of input (getting data into memory from the 
outside) is the same, no matter what specific technique or type of hardware device you use. 





4. Following the declarations, prompt the user for the minimum discount price, 
and accept a value from the keyboard: 


System.out.printC("Enter cutoff price for discount >>"); 
price = keyboard.nextDouble() ; 


5. Prompt the user for the discount rate, and accept it. 


System.out.print("Enter discount rate as a whole number >> "); 
discount = keyboard.nextDoubleQ) ; 


(continues) 
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(continued) 


6. After the call to displayInfoQ, insert a call to computeDiscountInfo(). You 
will pass the price and discount values to the method, and the method 
138 returns the minimum that a consumer will save, which is stored in savings: 





savings = computeDiscountInfo(price, discount); 


7. Just before the closing curly brace for the main@ method, display the savings 
information: 


System.out.printIn("Special this week on any service over " + 
price); 

System.out.printInC("Discount of " + discount + percent"); 

System.out.printInC"That's a savings of at least $" + savings); 


8. After the displayInfoQ method implementation, but before the closing curly 
brace for the class, add the computeDiscountInfo( method. It accepts two 
doubles and returns a double. 


public static double computeDiscountInfo(double pr, double dscnt) 
{ 

double savings; 

savings = pr * dscnt / 100; 

return savings; 


} 


9. Save the file, and then compile and execute it. Figure 3-22 shows a typical 
execution. After the user is prompted for the cutoff price for the week’s sale 
and the discount to be applied, the program executes the displayInfo() 
method. Then the program executes the computeDiscountInfo() method, 
which returns a value to store in the savings variable. Finally, the discount 
information is displayed. 





r 


fay Command Prompt 


C:\Java>java ParadiselInfo2 

Enter cutoff price for discount >> 56.66 
Enter discount rate as a whole number >> 46 
Paradise Day Spa wants to pamper you. 

We will make you look good. 

Special this week on any service over 56.6 
Discount of 46.6 percent 

That’s a savings of at least $20.6 


C:\Java>_ 














Figure 3-22 Typical execution of the ParadiseInfo2 program 
(continues) 
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(continued) 
Understanding That Methods Can Be Used as Black Boxes 


In this chapter, you have learned that methods can be used without knowing the 
details of their implementation. As an example of how professional programmers use 139 
implementation hiding, you can visit the Java Web site to see the interfaces for 

thousands of prewritten methods that reside in the Java prewritten classes. You are 

not allowed to see the code inside these methods; you see only their interfaces, 

which is all you need to be able to use the methods. 








1. Open your Web browser, go to the Java Web site, and navigate to the Java 
APIs for Java SE 7. 


2. From the alphabetical list of classes, select PrintStream. 


3. Atthe printStream page, read the descriptions of several methods for the 
class. Note that for each method, you can see the return type, method name, 
and parameter list, but you do not see the implementation for any of the 
existing methods. 


4. Examine other classes. Again, note that the Java documentation provides you 
with method interfaces but not implementations. When you develop your own 
classes in the future, you might choose to provide your users with similar 
documentation and compiled classes so that they cannot see, modify, or 
steal the code you have worked hard to develop. 


Learning About Classes and Objects 


When you think in an object-oriented manner, everything is an object, and every object is 

a member of a class. You can think of any inanimate physical item as an object—your desk, your 
computer, and the building in which you live are all called objects in everyday conversation. You 
can also think of living things as objects—your houseplant, your pet fish, and your sister are 
objects. Events are also objects—the stock purchase you made, the mortgage closing you 
attended, and a graduation party that was held in your honor are all objects. 


Everything is an object, and every object is a member of a more general class. Your desk is a 
member of the class that includes all desks, and your pet fish is a member of the class that 
contains all fish. An object-oriented programmer would say that your desk is an instance 

of the Desk class and your fish is an instance of the Fish class. These statements represent is-a 
relationships—that is, relationships in which the object “is a” concrete example of the class. 
Expressing an is-a relationship is correct only when you refer to the object and the class in the 
proper order. You can say, “My oak desk with the scratch on top is a Desk, and my goldfish 
named Moby is a Fish.” You don’t define a Desk by saying, “A Desk is an oak desk with a 
scratch on top,” or explain what a Fish is by saying, “A Fish is a goldfish named Moby,” 
because both a Desk and a Fish are much more general. The difference between a class and 
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an object parallels the difference between abstract and concrete. An object is an instantiation 
of a class, or one tangible example of a class. Your goldfish, my guppy, and the zoo’s shark 
each constitute one instantiation of the Fish class. 


about inheritance in the chapters Introduction to Inheritance and Advanced Inheritance Concepts. 


Programmers also use the phrase “is-a” when talking about inheritance relationships. You will learn more 
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The concept of a class is useful because of its reusability. Objects gain their attributes from 
their classes, and all objects have predictable attributes because they are members of certain 
classes. For example, if you are invited to a graduation party, you automatically know many 
things about the object (the party). You assume there will be a starting time, a certain number 
of guests, and some quantity of food. You understand what a party entails because of your 
previous knowledge of the Party class of which all parties are members. You don’t know the 
number of guests or what food will be served at this particular party, but you understand that 
because all parties have guests and refreshments, this one must too. Because you understand 
the general characteristics of a Party, you anticipate different behaviors than if you plan to 
attend a TheaterPerformance object or a DentalAppointment object. 


In addition to their attributes, objects have methods associated with them, and every object 
that is an instance of a class is assumed to possess the same methods. For example, for all 
Party objects, at some point you must set the date and time. In a program, you might name 
these methods setDate() and setTime(). Party guests need to know the date and time and 
might use methods named getDate() and getTime() to find out the date and time of any 
Party object. Method names that begin with get and set are very typical. You will learn more 
about get and set methods in the next section. 


Your graduation party, then, might have the identifier myGraduationParty. As a member 
of the Party class, myGraduationParty, like all Party objects, might have data methods 
setDate() and setTime(). When you use them, the setDate( and setTime() methods 
require arguments, or information passed to them. For example, statements such as 
myGraduationParty.setDate("May 12") and myGraduationParty.setTime("6 P.M.") 
invoke methods that are available for the myGraduationParty object. When you use an object 
and its methods, think of being able to send a message to the object to direct it to accomplish 
some task—you can tell the Party object named myGraduationParty to set the date and 
time you request. Even though yourAnniversaryParty is also a member of the Party 

class, and even though it also has access to setDate() and setTime() methods, the 
arguments you send to yourAnniversaryParty methods will be different from those you 
send to myGraduationParty methods. Within any object-oriented program, you are 
continuously making requests to objects’ methods and often including arguments as part of 
those requests. 


In addition, some methods used in an application must return a message or value. If one of 
your party guests uses the getDate() method, the guest hopes that the method will respond 
with the desired information. Similarly, within object-oriented programs, methods are often 
called upon to return a piece of information to the source of the request. For example, a 
method within a Payrol1 class that calculates federal withholding tax might return a tax 
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amount in dollars and cents, and a method within an Inventory class might return true or 
false, depending on the method’s determination of whether an item is at the reorder point. 


With object-oriented programming, sometimes you create classes so that you can instantiate 
objects from them, and other times you create classes to run as applications. Application 
classes frequently instantiate objects that use the objects of other classes (and their data and 
methods). Sometimes you write classes that do both. The same programmer does not need to 
write every class he or she uses. Often, you will write programs that use classes created by 
others; similarly, you might create a class that others will use to instantiate objects within 
their own applications. You can call an application or class that instantiates objects of another 
prewritten class a class client or class user. 
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The System class that you have used to produce output in the Command Prompt window provides an 
example of using a class that was written by someone else. You did not have to create it or its print InQ@ 
method; both were created for you by Java’s creators. 


method. The main() method is the starting point for any application. You will write and use many classes 
that do not contain a main() method—these classes can be used by other classes that are applications or 
applets. (You will learn about applets in the chapter Applets, Images, and Sound.) 


A Java application can contain only one method with the header 
GY public static void main(String[] args). If you write a class that imports another 


class, and both classes have a public main() method, your application will not compile. 


Q You can identify a class that is an application because it contains a public static void main() 


So far, you've learned that object-oriented programming involves objects that send messages 
to other objects requesting they perform tasks, and that every object belongs to a class. 
Understanding classes and how objects are instantiated from them is the heart of object- 
oriented thinking. 


Learning About Classes and Objects 


A class is an instantiation of many objects. 
Objects gain their attributes and methods from their classes. 


3. Anapplication or class that instantiates objects of another prewritten class is a 
class client. 
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Creating a Class 


When you create a class, you must assign a name to the class, and you must determine what 
data and methods will be part of the class. Suppose you decide to create a class named 
Employee. One instance variable of Employee might be an employee number, and two 
142 necessary methods might be a method to set (or provide a value for) the employee number 
and another method to get (or retrieve) that employee number. To begin, you create a class 
header with three parts: 





e An optional access specifier 

e The keyword class 

e Any legal identifier you choose for the name of your class 

For example, a header for a class that represents an employee might be: 
public class Employee 


The most liberal form of access is public. The keyword public is a class modifier. Classes 
that are public are accessible by all objects. Public classes also can be extended, or used as a 
basis for any other class. Making access public means that if you develop a good Employee 
class, and someday you want to develop two classes that are more specific, SalariedEmp1oyee 
and HourlyEmployee, then you do not have to start from scratch. Each new class can become 
an extension of the original Employee class, inheriting its data and methods. Although other 
specifiers exist, you will use the public specifier for most of your classes. 


Q You will learn about extended classes in the chapter Introduction to Inheritance. 


After writing the class header public class Employee, you write the body of the Employee class 
between a set of curly braces. The body contains the data and methods for the class. The data 
components of a class are often referred to as data fields to help distinguish them from other 
variables you might use. Figure 3-23 shows an Employee class that contains one data field named 
empNum. Data fields are variables you declare within a class but outside of any method. 


public class Employee 


{ 
3 


private int empNum; 





Figure 3-23 The Employee class with one field 


In Figure 3-23, the data field empNum is not preceded by the keyword static. If the keyword 
static had been inserted there, only one empNum value would be shared by all Employee 
objects that are eventually instantiated. Because the empNum field in Figure 3-23 is not 
preceded by static, when you eventually create, or instantiate, objects from the class, each 
Employee can have its own unique empNum. Each object gets its own copy of each nonstatic 
data field. A nonstatic field like empNum is an instance variable for the class. 
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You have already learned that the access specifier for most Java methods is public. However, 
most fields, like empNum in the Employee class, are private, which provides the highest level of 
security. Assigning private access to a field means that no other classes can access the field’s 
values, and only methods of the same class are allowed to set, get, or otherwise use private 
variables. The principle used in creating private access is sometimes called information hiding 
and is an important component of object-oriented programs. A class’s private data can be 143 
changed or manipulated only by a class’s own methods and not by methods that belong to 
other classes. In contrast to fields, most class methods are public, not private. The resulting 
private data/public method arrangement provides a means for you to control outside access 
to your data—only a class’s nonprivate methods can be used to access a class’s private data. 
The situation is similar to hiring a public receptionist to sit in front of your private office and 
control which messages you receive (perhaps deflecting trivial or hostile ones) and which 
messages you send (perhaps checking your spelling, grammar, and any legal implications). 
The way in which the nonprivate methods are written controls how you use the private data. 








protected. The private protected access level is not supported in versions of Java higher than 


The first release of Java (1.0) supported five access levels—the four listed previously plus private 
GY 1.0; you should not use it in your Java programs. 


In summary, a class’s data fields are most often private and not static. Data fields are most 
frequently made public when they are both static and final—that is, when a class contains 
a nonchanging value that you want to use without being required to create an object. For 
example, the Java Math class contains a public field called PI that you can use without 
instantiating a Math object. You will learn about the Math class in the next chapter. 


Creating a Class 
1. Aclass header contains an optional access specifier, the keyword class, and an 
identifier. 


2. When you instantiate objects, each has its own copy of each static data field in 
the class. 


3. Most fields in a class are private, and most methods are public. 
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Creating Instance Methods in a Class 


Besides data, classes contain methods. For example, one method you need for an Employee 
class that contains an empNum is the method to retrieve (or return) any Employee’s empNum for 
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use by another class. A reasonable name for this method is getEmpNum(), and its declaration is 
public int getEmpNum() because it will have public access, return an integer (the employee 
number), and possess the identifier getEmpNum(). 


Similarly, you need a method with which to set the empNum field. A reasonable name for this 
method is setEmpNum(), and its declaration is public void setEmpNum(int emp) because it 
will have public access, return nothing, possess the identifier setEmpNum(), and require a 
parameter that represents the employee’s ID number, which is type int. 
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Methods that set or change field values are called mutator methods; methods that retrieve 
values are called accessor methods. In Java, mutator methods conventionally start with the 
prefix set, and accessor methods conventionally start with the prefix get. Using these three- 
letter prefixes with your method names is not required, but it is conventional. Figure 3-24 
shows the get and set methods for the empNum field for the Employee class. 


public void setEmpNumCint emp) 
{ 


} 


empNum = emp; 


public int getEmpNumQ 
{ 


i 


return empNum; 





Figure 3-24 The setEmpNum() and getEmpNum() methods 


Notice that, unlike the methods you created earlier in this chapter, the getEmpNum() and 
setEmpNum() methods do not employ the static modifier. The keyword static is used 
for classwide methods, but not for methods that “belong” to objects. If you are creating a 
program with a main() method that you will execute to perform some task, many of 
your methods will be static so you can call them from within main() without creating 
objects. However, if you are creating a class from which objects will be instantiated, 
most methods will probably be nonstatic because you will associate the methods with 
individual objects. For example, the getEmpNum() method must be nonstatic because it 
returns a different empNum value for every Employee object you ever create. Nonstatic 
methods, those methods used with object instantiations, are called instance methods. 
You can use either a static or nonstatic method with an object, but only nonstatic 
methods behave uniquely for each object. You cannot use a nonstatic method without 
an object. 


Understanding when to declare fields and methods as static and nonstatic is a challenge for 
new programmers. To help you determine whether a data field should be static or not, you 
can ask yourself how many times it occurs. If it occurs once per class, it is static, but if it 

occurs once per object, it is not static. Table 3-1 provides a summary. 
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Static Nonstatic 
In Java, static is a keyword. It also can be There is no keyword for nonstatic items. When you 
used as an adjective. do not explicitly declare a field or method to be 


static, then it is nonstatic by default. 








Static fields in a class are called class fields. Nonstatic fields in a class are called instance 145 
variables. 

Static methods in a class are called class Nonstatic methods in a class are called instance 

methods. methods. 

When you use a static field or method, you do When you use a nonstatic field or method, 

not need to use an object; for example: you must use an object; for example: 

JOptionPane.showDialog() ; System.out.printinQO; 

When you create a class with a static field When you create a class with a nonstatic field and 

and instantiate 100 objects, only one copy of instantiate 100 objects, then 100 copies of that 

that field exists in memory. field exist in memory. 

When you create a static method in a class When you create a nonstatic method in a class and 

and instantiate 100 objects, only one copy of instantiate 100 objects, only one copy of the 

the method exists in memory and the method method exists in memory, but the method receives 

does not receive a this reference. a this reference that contains the address of the 


object currently using it. 


Static class variables are not instance Instance fields and methods are nonstatic. The 
variables. The system allocates memory to system allocates a separate memory location for 
hold class variables once per class, no each nonstatic field in each instance. 


matter how many instances of the class you 
instantiate. The system allocates memory for 
class variables the first time it encounters a 
class, and every instance of a class shares 

the same copy of any static class variables. 


Table 3-1 Comparison of static and nonstatic 


Q Table 3-1 mentions the this reference. You will learn about the this reference in the next chapter. 


Figure 3-25 also provides a summary of how public, private, static, and nonstatic class 
members can be used by another class. The figure shows a class named MyClass with four 
methods that are public static, private static, public nonstatic, and private nonstatic. 
The figure also shows a TestClass that instantiates a MyClass object. The TestClass 
contains eight method calls. The three valid calls are all to public methods. The call to the 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 3 Using Methods, Classes, and Objects 


nonstatic method uses an object, and the two calls to the static method can use an object or 
not. The rest of the TestClass code after the comment is invalid. Private methods cannot be 
called from outside the class, and nonstatic methods require an object. 
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public class MyClass 

{ ; 
public static pubStatMethod() The public static 
private static privStatMethod() method can be 
public pubNonstatMethod() used from 


5 : TestClass with 
private privNonstatMethod() St wilt an 


object. 


The public nonstatic method 
can be used from TestClass 
with aMyClass object. 
public class TestClass 
{ 
MyClass object = new MyClass(); 


object.pubNonstatMethod() ; 
TestClass doesn’t have 
access to the private object.pubStatMethodQ) ; 
method. 

MyClass.pubStatMethod() ; 


; None of the following work 
The nonstatic method must be 
used with a MyClass object. MyClass.privStatMethod() ; 


MyClass.pubNonstatMethod() ; 


An object can use a static or object.privStatMethodQ) ; 
nonstatic method, but these 


methods are private and object.privNonstatMethod() ; 
cannot be used here. 


MyClass.privNonstatMethod() ; 


This is wrong on two counts—the 
method is nonstatic, so it needs an 
object, and in any event, the 
method is private. 








Figure 3-25 Summary of legal and illegal method calls based on combinations of method modifiers 


Figure 3-26 shows the complete Employee class containing one private data field and two 
public methods, all of which are nonstatic. This class becomes the model for a new data type 
named Employee; when Employee objects eventually are created, each will have its own 
empNum field, and each will have access to two methods—one that provides a value for its 
empNum field and another that retrieves the value stored there. 
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public class Employee 


{ 


private int empNum; 
public int getEmpNum() 
{ 


} 
public void setEmpNum(Cint emp) 
{ 


i: 


return empNum; 147 








empNum = emp; 





Figure 3-26 The Employee class with one field and two methods 


When you create a class like Employee, you can compile it, which will identify typographical 
errors. However, you cannot execute the class because it does not contain a main() method. 
A class like Employee is intended to be used as a data type for objects within other 
applications, as you will see in the next section. 


Organizing Classes 


Most classes that you create have multiple data fields and methods. For example, in addition 
to requiring an employee number, an Employee needs a last name, a first name, and a salary, 
as well as methods to set and get those fields. Figure 3-27 shows how you could code the data 
fields for Employee. 


public class Employee 
{ 
private int empNum; 
private String empLastName; 


private String empFirstName; 
private double empSalary; 
// Methods will go here 





Figure 3-27 An Employee class with several data fields 


Although there is no requirement to do so, most programmers place data fields in some logical 
order at the beginning of a class. For example, empNum is most likely used as a unique identifier 
for each employee (what database users often call a primary key), so it makes sense to list the 
employee number first in the class. An employee’s last name and first name “go together,” so it 
makes sense to store these two Employee components adjacently. Despite these commonsense 
rules, you have a lot of flexibility in how you position your data fields within any class. 
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might have many employees with the last name Johnson or a weekly salary of $400.00, but there is only one 


A unique identifier is one that should have no duplicates within an application. For example, an organization 
GY employee with employee number 128. 


148 Because there are two String components in the current Employee class, they might be 
declared within the same statement, such as the following: 





private String empLastName, empFirstName; 


However, it is usually easier to identify each Employee field at a glance if the fields are listed 
vertically. 


You can place a class’s data fields and methods in any order within a class. For example, you could 
place all the methods first, followed by all the data fields, or you could organize the class so that 
several data fields are followed by methods that use them, and then several more data fields are 
followed by the methods that use them. This book follows the convention of placing all data fields 
first so that you can see their names and data types before reading the methods that use them. 


Even if the only methods in the Emp1oyee class started in Figure 3-27 include one set method and 
one get method for each instance variable, eight methods are required. When you consider an 
employee record for most organizations, you will realize that many more fields are often required 
(such as address, phone number, hire date, number of dependents, and so on), as well as many 
more methods. Finding your way through the list can become a formidable task. For ease in 
locating class methods, many programmers store them in alphabetical order. Other programmers 
arrange values in pairs of get and set methods, an order that also results in functional groupings. 
Figure 3-28 shows how the complete class definition for an Employee might appear. 


public class Employee 

{ 
private int empNum; 
private String empLastName; 
private String empFirstName; 
private double empSalary; 
public int getEmpNum() 
{ 


return empNum; 


} 
public void setEmpNumCint emp) 


1 


} 
public String getEmpLastName() 


{ 
} 
public void setEmpLastName(String name) 


{ 
} 


empNum = emp; 


return empLastName; 


empLastName = name; 





Figure 3-28 The Employee class with several data fields and corresponding methods (continues) 
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(continued) 


public String getEmpFirstName() 
{ 


return empFirstName; 


} 
public void setEmpFirstName(String name) sid 


{ 
} 








empFirstName = name; 


public double getEmpSalary() 
{ 


return empSalary; 
} 
public void setEmpSalary(double sal) 


{ 
} 


empSalary = sal; 





Figure 3-28 The Employee class with several data fields and corresponding methods 


The Employee class is still not a particularly large class, and each of its methods is very short, 
but it is already becoming quite difficult to manage. It certainly can support some well-placed 
comments. For example, the purpose of the class and the programmer’s name might appear 
in comments at the top of the file, and comments might be used to separate the data and 
method sections of the class. Your organization might have specific recommendations or 
requirements for placing comments within a class. 


Creating Instance Methods in a Class 


1. The keyword static is used with classwide methods, but not for methods that 
“belong” to objects. 


2. When you create a class from which objects will be instantiated, most methods are 
nonstatic because they are associated with individual objects. 


3. Static methods are instance methods. 
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iN You Do It 


Creating a Class That Contains Instance Fields and Methods 


Next, you create a class to store information about event services offered at 
Paradise Day Spa. 


1. Open anew document in your text editor, and type the following class header 
and the curly braces to surround the class body: 
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public class SpaService 
{ 
} 
2. Between the curly braces for the class, insert two private data fields that will 
hold data about a spa service: 


private String serviceDescription; 
private double price; 


3. Within the class’s curly braces and after the field declarations, enter the 
following two methods that set the field values. The setServiceDescriptionO 
method accepts a String parameter and assigns it to the serviceDescription 
field for each object that eventually will be instantiated. Similarly, the setPriceQ 
method accepts a double parameter and assigns it to the price field. Note that 
neither of these methods is static. 


public void setServiceDescription(String service) 


{ 

serviceDescription = service; 
} 
public void setPrice(double pr) 
{ 

price = pr; 
} 


4. Next, add two methods that retrieve the field values as follows: 


public String getServiceDescription() 
{ 


return serviceDescription; 


} 
public double getPrice() 
{ 


} 


5. Save the file as SpaService.java, compile it, and then correct any syntax 
errors. Remember, you cannot run this file as a program because it does not 
contain a public static main® method. After you read the next section, you 
will use this class to create objects. 


return price; 
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Declaring Objects and Using Their Methods 


Declaring a class does not create any actual objects. A class is just an abstract description of 
what an object will be like if any objects are ever actually instantiated. Just as you might 

understand all the characteristics of an item you intend to manufacture long before the first 
item rolls off the assembly line, you can create a class with fields and methods long before you 151 
instantiate any objects that are members of that class. 








A two-step process creates an object that is an instance of a class. First, you supply a type and 
an identifier—just as when you declare any variable—and then you allocate computer 
memory for that object. For example, you might declare an integer as int someValue; and 
you might declare an Employee as follows: 


Employee someEmployee; 


In this statement, someEmployee stands for any legal identifier you choose to represent an 
Emp loyee. 


When you declare an integer as int someValue;, you notify the compiler that an integer 
named someValue will exist, and you reserve computer memory for it at the same time. When 
you declare the someEmployee instance of the Employee class, you are notifying the compiler 
that you will use the identifier someEmployee. However, you are not yet setting aside 
computer memory in which the Employee named someEmployee might be stored—that is 
done automatically only for primitive type variables. To allocate the needed memory for an 
object, you must use the new operator. Two statements that actually set aside enough 
memory to hold an Employee are as follows: 


Employee someEmployee; 
someEmployee = new EmployeeQ); 


Q You first learned about the new operator when you created a Scanner object in Chapter 2. 


Instead of using two statements, you can declare and reserve memory for someEmployee in 
one statement, as in the following: 


Employee someEmployee = new Employee(); 


In this statement, Employee is the object’s type (as well as its class), and someEmployee is the 
name of the object. In this statement, someEmployee becomes a reference to the object—the 
name for a memory address where the object is held. Every object name is also a reference— 
that is, a computer memory location. In Chapter 2, you learned that a class like Employee is a 
reference type. 


The equal sign is the assignment operator, so a value is being assigned to someEmp1oyee in the 
declaration. The new operator is allocating a new, unused portion of computer memory for 
someEmployee. The value that the statement is assigning to someEmployee is a memory 
address at which someEmployee is to be located. You do not need to be concerned with what 
the actual memory address is—when you refer to someEmployee, the compiler locates it at the 
appropriate address for you. 
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The final portion of the statement after the new operator, Employee(), with its parentheses, 

looks suspiciously like a method name. In fact, it is the name of a method that constructs an 

Employee object. The Employee() method is a constructor, a special type of method that 

creates and initializes objects. You can write your own constructor for a class, and you will 

learn how later in this chapter. However, when you don’t write a constructor for a class, Java 

152 writes one for you. Whether you write your own constructor or use the one automatically 
created by Java, the name of the constructor is always the same as the name of the class whose 
objects it constructs. 





After an object has been instantiated, its methods can be accessed using the object’s identifier, 
a dot, and a method call. For example, Figure 3-29 shows an application that instantiates two 
Employee objects. The two objects, clerk and driver, each use the setEmpNum() and 
getEmpNum() method one time. The DeclareTwoEmployees application can use these 
methods because they are public, and it must use them with an Employee object because the 
methods are not static. Figure 3-30 shows the output of the application. 


public class DeclareTwoEmployees 
{ 
public static void main(String[] args) 
{ 
Employee clerk = new Employee(); 
Employee driver = new Employee(); 
clerk. setEmpNum(345) ; 
driver.setEmpNum(567) ; 


System.out.printInC"The clerk's number is + 
clerk.getEmpNum(Q) + 
driver.getEmpNum()) ; 


and the driver's number is + 


clareTwoEmployees 
number is 345 and the driver’s number 








Figure 3-30 Output of the DeclareTwoEmployees application 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





Declaring Objects and Using Their Methods D0 


application. If the Employee.java file was stored in a different folder, you would need an import statement at 


The program in Figure 3-29 assumes that the Employee.java file is stored in the same folder as the 
GY the top of the file, similar to the ones you use for the Scanner and JOptionPane classes. 


153 








Understanding Data Hiding 


Within the DeclareTwoEmployees class, you must use the public methods setEmpNum() and 
getEmpNum() to be able to set and retrieve the value of the empNum field for each Employee 
because you cannot access the private empNum field directly. For example, the following 
statement would not be allowed: 


clerk.empNum = 789; 


This statement generates the error message “empNum has private access in Employee”, 
meaning you cannot access empNum from the DeclareTwoEmployees class. If you made empNum 
public instead of private, a direct assignment statement would work, but you would violate 
an important principle of object-oriented programming—that of data hiding using 
encapsulation. Data fields should usually be private, and a client application should be able to 
access them only through the public interfaces—that is, through the class’s public methods. 
However, you might reasonably ask, “When I write an application, if 1 can’t set an object’s 
data field directly, but I can set it using a public method, what’s the difference? The field value 
is set either way!” Actually, the setEmpNum() method in the Employee class in Figure 3-26 does 
accept any integer value you send into it. However, you could rewrite the setEmpNum() 
method to prevent invalid data from being assigned to an object’s data fields. For example, 
perhaps your organization has rules for valid employee ID numbers—they must be no fewer 
than five digits, or they must start with a 9, for instance—or perhaps you calculate a check- 
digit that is appended to every employee ID number. The statements that enforce these 
requirements would be part of the setEmpNum() method. Checking a value for validity 
requires decision making. You will learn more in the chapter Making Decisions. 


ensures that the number is valid. For example, an organization might use five-digit employee ID numbers in 
which the fifth digit is calculated by dividing the first four by 7 and taking the remainder. As an example, if the 
first four digits of your ID number are 7235, then the fifth digit is 4, the remainder when you divide the first 
four digits by 7. So the five-digit ID becomes 72354. Later, if you make a mistake and enter your ID into a 
company application as 82354, the application would divide the first four digits, 8235, by 7. The remainder 
is not 4, and the ID would be found invalid. 


Q A check-digit is a number appended to a field, typically an ID number or account number. The check-digit 


Similarly, a get method might control how a value is retrieved. Perhaps you do not want 
clients to have access to part of an employee’s ID number, or perhaps you always want to add 
a company code to every ID before it is returned to the client. Even when a field has no data 
value requirements or restrictions, making data private and providing public set and get 
methods establishes a framework that makes such modifications easier in the future. You will 
not necessarily write set and get methods for every field in a class; there are some fields that 
clients will not be allowed to alter. Some fields will simply be assigned values, and some field 
values might be calculated from the values of others. 
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ee ; 
4 Watch the video Classes and Objects. 
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Declaring Objects and Using Their Methods 





1. When you declare an object, you give it a name and set aside enough memory for 
the object to be stored. 


An object name is a reference; it holds a memory address. 


3. When you don’t write a constructor for a class, Java creates one for you; the name 
of the constructor is always the same as the name of its class. 
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aN You Do It 


Declaring and Using Objects 


In the previous “You Do It” section, you created a class named SpaService. Now you 
create an application that instantiates and uses SpaService objects. 


1. Open anew file in your text editor, and type the import statement needed for 
an interactive program that accepts user keyboard input: 
import java.util .Scanner; 

2. Create the shell for a class named CreateSpaServices: 


public class CreateSpaServices 
{ 
} 


3. Between the curly braces of the CreateSpaServices Class, create the shell 
for a main@ method for the application: 
public static void main(String[] args) 


{ 
} 


(continues) 
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(continued) 


4. Within the main® method, declare variables to hold a service description and 
price that a user can enter from the keyboard: 


String service; 155 
double price; 








5. Next, declare three objects. Two are SpaService objects that use the class you 
created in the prior set of “You Do It” steps. The third object uses the built-in Java 
Scanner Class. Both classes use the new operator to allocate memory for their 
objects, and both call a constructor that has the same name as the class. The 
difference is that the Scanner constructor requires an argument (System. in), but 
the SpaService Class does not. 

SpaService firstService = new SpaService(); 


SpaService secondService = new SpaService() ; 
Scanner keyboard = new Scanner (System. in) ; 


6. Inthe next statements, you prompt the user for a service, accept it from the 
keyboard, prompt the user for a price, and accept it from the keyboard. 
System.out.printC"Enter service >> "); 
service = keyboard.nextLineQ ; 


System.out.printC"Enter price >> "); 
price = keyboard.nextDoubleQ) ; 


7. Recall that the setServiceDescription() method in the SpaService Class Is 
nonstatic, meaning it is used with an object, and that it requires a String 
argument. Write the statement that sends the service the user entered to the 
setServiceDescription() method for the firstService object: 


firstService.setServiceDescription(service) ; 


8. Similarly, send the price the user entered to the setPrice() method for the 
firstService object. Recall that this method is nonstatic and requires a double 
argument. 


firstService.setPrice(price) ; 


9. Make a call to the nextLined method to remove the Enter key that remains in 
the input buffer after the last numeric entry. Then repeat the prompts, and 
accept data for the second SpaService object. 


keyboard. nextLineQ) ; 

System.out.print("Enter service >> "); 
service = keyboard.nextLineQ) ; 
System.out.print("Enter price >> "); 

price = keyboard.nextDoubleQ) ; 
secondService.setServiceDescription(service) ; 
secondService.setPrice(price) ; 


(continues) 
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(continued) 


10. Display the details for the firstService object. 


System.out.printIn("First service details:"); 
156 System.out.printIn(firstService.getServiceDescription() + 
"  $" + firstService.getPrice()); 





11. Display the details for the secondService object. 


System.out.printInC"Second service details:"); 
System. out.printIn(secondService.getServiceDescription() + 
$" + secondService.getPriceQ); 


12. Save the file as CreateSpaServices.java. Compile and execute the program. 
Figure 3-31 shows a typical execution. Make sure you understand how the user’s 
entered values are assigned to and retrieved from the two SpaService objects. 





fa Command Prompt roy 


" service >> facial 
* price >> 28.95 
* service >> manicure 
* price >> 35.25 
service details: 
facial $28.95 


[Second service details: 
Manicure $35.25 


C:\Java> 














Figure 3-31 Typical execution of the CreateSpaServices program 


An Introduction to Using Constructors 


When you create a class, such as Employee, and instantiate an object with a statement such as 
the following, you are actually calling the Employee class constructor that is provided by 
default by the Java compiler: 


Employee chauffeur = new Employee(); 


A constructor establishes an object; a default constructor is one that requires no arguments. 
A default constructor is created automatically by the Java compiler for any class you create 
whenever you do not write your own constructor. 


When the prewritten, default constructor for the Employee class is called, it establishes one 
Employee object with the identifier provided. The automatically supplied default constructor 
provides the following specific initial values to an object’s data fields: 
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e Numeric fields are set to 0 (zero). 
e Character fields are set to Unicode ‘\u0000’. 
e Boolean fields are set to false. 


e Fields that are object references (for example, String fields) are set to nu11 (or empty). 
157 








If you do not want each field in an object to hold these default values, or if you want to perform 
additional tasks when you create an instance of a class, you can write your own constructor. 
Any constructor you write must have the same name as the class it constructs, and 
constructors cannot have a return type. You never provide a return type for a constructor—not 
even void. Normally, you declare constructors to be public so that other classes can instantiate 
objects that belong to the class. When you write a constructor for a class, you no longer have 
access to the automatically created version. 


For example, if you want every Employee object to have a default starting salary of $300.00 per 
week, you could write the constructor for the Employee class that appears in Figure 3-32. Any 
Employee object instantiated will have an empSalary field value equal to 300.00, and the other 
Employee data fields will contain the automatically supplied default values. Even though you 
might want a field to hold the default value, you still might prefer to explicitly initialize the 
field for clarity. 


public Employee() 
{ 


} 


empSalary = 300.00; 





Figure 3-32 The Employee class constructor 


The Emp] oyee class constructor in Figure 3-32 takes no parameters. Therefore, it is a default constructor. 
GY You will learn about nondefault constructors that take parameters in the next chapter. 


You can write any Java statement in a constructor. Although you usually have no reason to do 
so, you could display a message from within a constructor or perform any other task. 


You can place the constructor anywhere inside the class, outside of any other method. 
Typically, a constructor is placed with the other methods. Often, programmers list the 
constructor first because it is the first method used when an object is created. 


You never are required to write a constructor for a class; Java provides you with a default 
version if the class contains no explicit constructor. 


A class can contain multiple constructors. You will learn how to overload constructors in the 
Y next chapter. 
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An Introduction to Using Constructors 








1. In Java, you cannot write a default constructor; it must be supplied for you 
automatically. 


2. The automatically supplied default constructor sets all numeric fields to 0, 
character fields to Unicode \u0000’, Boolean fields to false, and fields that are 
object references to nu11. 


3. When you write a constructor, it must have the same name as the class it 
constructs, and it cannot have a return type. 
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aN You Do It 


Adding a Constructor to a Class 


1. Open the SpaService.java file that you created in a “You Do It” section 
earlier in this chapter. 


2. After the field declarations, and before the method declarations, insert an 
explicit default constructor that sets serviceDescription to “XXX” and price 
to 0. Because numeric fields in objects are set to O by default, the last 
assignment is not really necessary. However, programmers sometimes code 
a statement like the one that sets price to 0 so that their intentions are clear 
to people reading their programs. 


(continues) 
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(continued) 


public SpaService() 
{ 
serviceDescription = "XXX"; 
price =0; 159 








} 
3. Save the class and compile it. 


4. Open the CreateSpaServices.java file. Comment out the seven statements 
that prompt for, receive, and set the values for the secondService object by 
placing double slashes at the start of their lines, as shown below. By comment- 
ing out these lines, you change the program so that the user does not enter 
values for the secondService object. Instead, the values assigned by the con- 
structor are the final values for the object. 


// keyboard.nextLineQ) ; 

// System.out.printC"Enter service >> "); 

// service = keyboard.nextLineQ ; 

// System.out.printC"Enter price >> "); 

// price = keyboard.nextDoubleQ ; 

// secondService.setServiceDescription(service) ; 
// secondService.setPrice(price) ; 


5. Save the file, and then compile and execute it. Figure 3-33 shows a typical 
execution. The firstService object contains values supplied by the user, 
but the secondService object shows the values assigned during the object's 
construction. 





fy Command Prompt 


C:\Java>java CreateSpaServices 
Enter service >> aromatherapy 
Enter price >> 19.99 

First service details: 








Figure 3-33 Typical execution of CreateSpaServices program that uses constructor 
values for the second object 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall lear earning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 3 Using Methods, Classes, and Objects 


Understanding That Classes Are Data Types 


The classes that you create become data types. Programmers sometimes refer to 

classes as abstract data types, or ADTs. An abstract data type is a type whose implementation 

is hidden and accessed through its public methods. A class can also be called a programmer- 
160 defined data type; in other words, it is a type that is not built into the language. A class is a 
composite type—that is, a class is composed from smaller parts. 





Java’s primitive types are not composite. Java has eight built-in primitive data types such as 
int and double. Primitive types can also be called scalar types. You do not have to define 
these simple types; the creators of Java have already done so. For example, when the int type 
was first created, the programmers who designed it had to think of the following: 


Q: What shall we call it? 

A: int. 

Q: What are its attributes? 

A: An int is stored in four bytes; it holds whole-number values. 

Q: What methods are needed by int? 

A: A method to assign a value to a variable (for example, num = 32;). 

Q: Any other methods? 

A: Some operators to perform arithmetic with variables (for example, num + 6). 

Q: Any other methods? 

A: Of course, there are even more attributes and methods of an int, but these are a 
good start. 


Your job in constructing a new data type is similar. If you need a class for employees, you 
should ask: 


Q: What shall we call it? 
Employee. 
What are its attributes? 


A 
Q 
A: It has an integer ID number, a String last name, and a double salary. 
Q: What methods are needed by Employee? 

A 


A method to assign values to a member of this class (for example, one Employee’s 
ID number is 3232, her last name is “Walters”, and her salary is 30000). 


Q: Any other methods? 


A: A method to display data in a member of this class (for example, display one 
Employee’s data). 


Q: Any other methods? 
A: Probably, but this is enough to get started. 
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When you declare a primitive type object, you provide its type and an identifier. When you 
declare an object from one of your classes, you do the same. After each exists, you can use 
them in very similar ways. For example, suppose you declare an int named myInt and an 
Employee named myEmployee. Then each can be passed into a method, returned from a 


method, or assigned to another object of the same data type. 
161 








For example, Figure 3-34 shows a program in which the main() method uses two other 
methods. One method accepts an Employee as a parameter, and the other returns an 
Employee. (The Employee class is defined in Figure 3-28.) Figure 3-35 shows a typical 
execution. You can see in this sample program that an Employee is passed into and out of 
methods just like a primitive object would be. Classes are not mysterious; they are just new 
data types that you invent. 


import java.util.Scanner; 
class MethodsThatUseAnEmployee 
{ 
public static void main (String args[]) 
{ 
Employee myEmployee; 
myEmployee = getEmployeeData() ; 
displayEmployee(myEmployee) ; 
} 
public static Employee getEmployeeData() 
{ 
Employee tempEmp = new Employee(); 
int id; 
double sal; 
Scanner input = new Scanner(System.in); 
System.out.printC"Enter employee ID >> "); 
id = input.nextintQ; 
tempEmp.setEmpNum(id) ; 
System.out.printC"Enter employee salary >> "); 
sal = input.nextDouble() ; 
tempEmp.setEmpSalary(sal); 
return tempEmp; 
} 
public static void displayEmployee(Employee anEmp) 
{ 
System.out.printInC"\nEmployee #" + anEmp.getEmpNum() + 
" Salary is " + anEmp.getEmpSalary()); 





Figure 3-34 The MethodsThatUseAnEmp1oyee application 
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C:\Java>java MethodsThatUseAnEmployee 
Enter employee ID >> 732 
Enter employee salary >> 745.25 





Employee #732 Salary is 745.25 


EAE Ur. 











Figure 3-35 Typical execution of the MethodsThatUseAnEmployee 
application 


Notice in the application in Figure 3-34 that the Employee declared in the main() method 
is not constructed there. An Employee is constructed in the getEmployeeData() method 
and passed back to the main() method, where it is assigned to the myEmployee reference. 
The Employee constructor could have been called in mainQ, but the values assigned would 
have been overwritten after the call to getEmployeeData(). 





Understanding That Classes Are Data Types 


1. When you declare a primitive variable or instantiate an object from a class, you 
provide both a type and an identifier. 


2. Unlike a primitive variable, an instantiated object cannot be passed into or returned 
from a method. 


3. The address of an instantiated object can be assigned to a declared reference of 
the same type. 
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In this section, you modify the CreateSpaServices Class to include a method for data 
entry. This change makes the mainQ® method shorter, gives you the ability to reuse 
code, and shows that an object of the SpaService class data type can be returned 
from a method as easily as a primitive data type. 


1. Open the CreateSpaServices.java file if it is not still open in your text editor. 


2. Delete the declarations for service, price, and keyboard. Declarations for 
these variables will now be part of the data entry method that you will create. 


3. Delete the six statements that prompt the user and get values for the 
firstService objects. Also delete the seven statements that prompt the 
user and retrieve data for the secondService object. You commented out 
these statements in the previous “You Do It” section. 


4. Inplace of the statements you just deleted, insert two new statements. The 
first sends a copy of the firstService object to a method named getData(). 
The method returns a SpaService object that will be filled with appropriate 
data, and this object is assigned to firstService. The second statement 
does the same thing for secondService. 


firstService = getData(firstService); 
secondService = getData(secondService) ; 


5. After the closing curly brace for the main© method, but before the closing 
curly brace for the class, start the following public static getDataQ 
method. The header indicates that the method both accepts and returns a 
SpaService object. Include the opening curly brace for the method, and make 
declarations for service, price, and keyboard. 


public static SpaService getData(SpaService s) 
{ 

String service; 

double price; 

Scanner keyboard = new Scanner (System. in); 


(continues) 
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(continued) 


6. Continue the method by prompting the user for and accepting a service and its 
price. Include a final call to nextLineQ so that the input buffer is cleared after 
164 the last numeric entry. 





System.out.printC"Enter service >> "); 
service = keyboard.nextLineQ) ; 
System.out.print("Enter price >>"); 
price = keyboard.nextDouble() ; 
keyboard. nextLineQ ; 


7. Finish the method by assigning the entered service and price to the SpaService 
object parameter using the SpaService class's setServiceDescription() and 
setPrice() methods. Then return the full object to the main method, where it 
is assigned to the object used in the method call. Add a closing curly brace for 
the method. 


s.setServiceDescription(service) ; 
s.setPrice(price) ; 
return s; 


} 


8. Save the file, compile it, and execute it. Figure 3-36 shows a typical execution. 
The execution is no different from the original version of the program, but by 
creating a method that accepts an unfilled SpaService object and returns one 
filled with data, you have made the mainQ method shorter and reused the data 
entry code. 


fa 
fa Command Prompt rox 


C:\Java>java CreateSpaServices 
* service >> hot wax treatment 
* price >> 34.75 
" service >> pedicure 
* price >> 38.95 
service details: 
hot wax treatment $34.75 
Second service details: 
pedicure $38.95 





C:\Java> 














Figure 3-36 Typical execution of the CreateSpaServices program that uses 
a data entry method 
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Key Terms 


Don't Do It 


e Don't place a semicolon at the end of a method header. After you get used to putting 
semicolons at the end of every statement, it’s easy to start putting them in too many 
places. Method headers never end in a semicolon. 


e Don't think “default constructor” means only the automatically supplied constructor. 165 
Although a class’s automatically supplied constructor is a default constructor, so is any 
constructor you create that accepts no parameters. 








e Don’t think that a class’s methods must accept its own fields’ values as parameters or 
return values to its own fields. When a class contains both fields and methods, each 
method has direct access to every field within the class. 


e Don’t create a class method that has a parameter with the same identifier as a class field— 
yet. If you do, you will only be allowed to access the local variable within the method, and 
you will not be able to access the field. You will be able to use the same identifier and still 
access both values after you read the next chapter. For now, make sure that the parameter 
in any class method has a different identifier from any class field. 





Key Terms 

A method is a program module that contains a series of statements that carry out a task. 
When you invoke or call a method, you execute it. 

The calling method makes a method call that invokes the called method. 

A client method is a method that calls another. 


Abstraction is the programming feature that allows you to use a method name to encapsulate 
a series of statements. 


The method header is the first line of the method and contains information about how other 
methods can interact with it. 


A declaration is another name for a method header. 











A method body is the set of statements between curly braces that follow the header and that 
carry out the method’s actions. 


Implementation describes the actions that execute within a method—the method body. 


A stub is a method that contains no statements; programmers create stubs as temporary 
placeholders during the program development process. 


Access modifier is sometimes used as another term for access specifier. 
A return type indicates the type of data that, upon completion of the method, is sent back to 


its calling method. 
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To return a value is to send the value from a called method back to the calling method. 


A fully qualified identifier includes a class name and a dot before the identifier. 
Arguments are data items sent to methods in a method call. 


166 Parameters are the data items received by a method. 





Implementation hiding is a principle of object-oriented programming that describes the 
encapsulation of method details within a class. 


The interface to a method includes the method’s return type, name, and arguments. It is the 
part that a client sees and uses. 


A black box is a device you can use without understanding how it works. 
A local variable is known only within the boundaries of a method. 


A method’s signature is the combination of the method name and the number, types, and 
order of arguments. 


Actual parameters are the arguments in a method call. 


Formal parameters are the variables in a method declaration that accept the values from 
actual parameters. 


A return statement ends a method and frequently sends a value from a called method back 
to the calling method. 


A method's type is its return type. 


Unreachable statements are those that cannot be executed because the logical path can never 
encounter them; an unreachable statement causes a compiler error. 


Dead code is a set of statements that are logically unreachable. 
An is-a relationship is the relationship between an object and the class of which it is a member. 
An instantiation of a class is an object; in other words, it is one tangible example of a class. 


A class client or class user is an application or class that instantiates objects of another 
prewritten class. 











Classes can be extended, or used as a basis for any other class. 
Data fields are data variables declared in a class outside of any method. 


The instance variables of a class are its data components. 


Assigning private access to a field means that no other classes can access the field’s values, 
and only methods of the same class are allowed to set, get, or otherwise use private variables. 


Information hiding is the object-oriented programming principle used when creating private 
access for data fields; a class’s private data can be changed or manipulated only by a class’s 
own methods and not by methods that belong to other classes. 


Mutator methods set values. 
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Chapter Summary) 


Accessor methods retrieve values. 
Nonstatic methods, those methods used with object instantiations, are called instance methods. 
A primary key is a unique identifier for data within a database. 


The new operator allocates the memory needed to hold an object. 
167 








A reference to an object is the name for a memory address where the object is held. 


A constructor is a method that establishes an object. 


A default constructor is one that requires no parameters; if you do not write one, a default 
constructor is created for a class automatically by the Java compiler. 


An abstract data type is a type whose implementation is hidden and accessed through its 
public methods. 


A programmer-defined data type is one that is created by a programmer and not built into 
the language. 


Chapter Summary 


e A method is a series of statements that carry out a task. Any method can call, or invoke, 
another. You place a method within a class outside of any other methods. 


e Methods must include a declaration (or header or definition), an opening curly brace, a 
body, and a closing curly brace. A method declaration contains optional access specifiers, 
the return type for the method, the method name, an opening parenthesis, an optional list 
of parameters, and a closing parenthesis. 


e When you write the method declaration for a method that can receive a parameter, you 
need to include the parameter type and a local name for the parameter within the method 
declaration parentheses. You can pass multiple arguments to methods by listing the 
arguments separated by commas within the call to the method. The arguments you send 
to the method must match (both in number and in type) the parameters listed in the 
method declaration. 


e The return type for a method (the method’s type) can be any Java type, including void. 
You use a return statement to send a value back to a calling method. 













e Objects are concrete instances of classes. Objects gain their attributes from their classes, 
and all objects have predictable attributes because they are members of certain classes. In 
addition to their attributes, objects have methods associated with them, and every object 
that is an instance of a class is assumed to possess the same methods. 


e A class header contains an optional access specifier, the keyword class, and any legal 
identifier you choose for the name of your class. A class contains fields, which are 
frequently private, and methods, which are frequently public. 


e Nonstatic instance methods operate uniquely for every object. Programmers can organize 
their classes in many ways. Fields can be placed before or after methods, and methods can 
be placed in any logical order. 
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e To create an object that is an instance of a class, you supply a type and an identifier, 
and then you allocate computer memory for that object using the new operator and the 
class constructor. With well-written object-oriented programming methods, using 
implementation hiding—or the encapsulation of method details within a class—means 
that the calling method needs to understand only the interface to the called method. 


168 e Aconstructor establishes an object and provides specific initial values for the object’s data 


fields. A constructor always has the same name as the class of which it is a member. By 
default, numeric fields are set to 0 (zero), character fields are set to Unicode ‘\u0000’, 
Boolean fields are set to false, and object type fields are set to nu11. 





e A class is an abstract, programmer-defined data type, similar to Java’s built-in, primitive 
data types. 


Review Questions 


1. In Java, methods must include all of the following except 





a declaration 
a call to another method 
curly braces 


ao FP 


a body 


2. All method declarations contain 





a. the keyword static 

b. one or more explicitly named access specifiers 
c. arguments 

d. parentheses 


3. A public static method named computeSum() is located in classA. To call the 
method from within classB, use the statement 





computeSum(classB) ; 
classB(computeSum()) ; 


classA.computeSum() ; 










ao FT PS 


You cannot call computeSum() from within classB. 


4, Which of the following method declarations is correct for a static method named 
displayFacts() if the method receives an int argument? 

public static int displayFacts( 

public void displayFacts(Cint data) 

public static void displayFacts(Cint data) 


oo fF PS 


Two of these are correct. 
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10. 


Review Questions 


The method with the declaration public static int aMethod(double d) has a 
method type of 





a. static 

b. int 

c. double 

d. You cannot determine the method type. 


Which of the following is a correct call to a method declared as public static void 
aMethod(char code)? 

a. void aMethod(); 

b. void aMethod(‘V’); 

c. aMethod(char ‘M’); 

d. aMethod(‘Q’); 

A method is declared as public static void showResults (doubled, inti). Which 
of the following is a correct method call? 

a. showResults(double d, inti); 

b. showResults(12.2, 67); 

c. showResults(4, 99.7); 

d. Two of these are correct. 


The method with the declaration public static char procedure(double d) has a 
method type of 





a. public 
b. static 
c. char 

d. double 


The method public static boolean testValue(int response) 
returns 





a boolean value 
an int value 
no value 


ae oP 


You cannot determine what is returned. 


Which of the following could be the last legally coded line of a method declared as 
public static int getVal (double sum)? 

a. return; 

b. return 77; 

c. return 2.3; 

d. Any of these could be the last coded line of the method. 
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11. The nonstatic data components of a class often are referred to as 








the of that class. 
a. access types 
b. instance variables 
170 c. methods 
d. objects 


12. Objects contain methods and data items, which are also known as 


a. fields 

b. functions 
c. themes 

d. instances 





13. You send messages or information to an object through its 


a. fields 
b. methods 
c. classes 
d. type 
14. A program or class that instantiates objects of another prewritten class is 
a(n) 
a. class client 
b. superclass 
c. object 
d. patron 


15. The body of a class is always written 





in a single line, as the first statement in a class 
within parentheses 
between curly braces 









ao F SP 


as a method call 


16. Most class data fields are 





a. private 
b. public 
c. static 
d. final 
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Exercises 


17. The concept of allowing a class’s private data to be changed only by a class’s own 
methods is known as 





structured logic 
object orientation 
information hiding 171 


ao fF SP 








data masking 


18. Suppose you declare an object as Book thisBook;. Before you store data in thisBook, 
you 





a. also must explicitly allocate memory for it 

b. need not explicitly allocate memory for it 

c. must explicitly allocate memory for it only if it has a constructor 
d. can declare it to use no memory 


19. Ifaclass is named Student, the class constructor name is 





a. any legal Java identifier 

b. any legal Java identifier that begins with S 
c. StudentConstructor 

d. Student 


20. If you use the automatically supplied default constructor when you create an 
object, 


a. numeric fields are set to 0 (zero) 
b. character fields are set to blank 
c. Boolean fields are set to true 

d. All of these are true. 


Exercises 


=) Programming Exercises 






1. Suppose that you have created a program with only the following variables: 
int v = 4; 
int w = 6; 
double x = 2.2; 
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Suppose that you also have a method with the following header: 
public static void calculate(int x, double y) 


Which of the following method calls are legal? 


a. calculate(v, w); d. calculate(18, x); 
b. calculate(v, x); e. calculate(1.1, 2.2); 
c. calculate(x, y); f. calculate(5, 7); 


Suppose that a class named ClassA contains a private nonstatic integer named b, a 
public nonstatic integer named c, and a public static integer named d. Which of the 
following are legal statements in a class named ClassB that has instantiated an object 
as ClassA obA = new ClassA() 3? 


a. obA.b=12; d. ClassA.b=4; 
b. obA.c=5; e. ClassA.c = 33; 
c. obA.d=23; f. ClassA.d=99; 
a. Create an application named ArithmeticMethods whose main() method holds 


two integer variables. Assign values to the variables. In turn, pass each value to 
methods named displayNumberPlus10(), displayNumberP1lus100(), and 
displayNumberP1us1000(). Create each method to perform the task its name 
implies. Save the application as ArithmeticMethods.java. 


b. Modify the ArithmeticMethods class to accept the values of the two integers from 
a user at the keyboard. Save the file as ArithmeticMethods2.java. 


a. Create an application named Percentages whose main() method holds two double 
variables. Assign values to the variables. Pass both variables to a method named 
computePercent() that displays the two values and the value of the first number as a 
percentage of the second one. For example, if the numbers are 2.0 and 5.0, the method 
should display a statement similar to “2.0 is 40% of 5.0.” Then call the method a second 
time, passing the values in reverse order. Save the application as Percentages.java. 


b. Modify the Percentages class to accept the values of the two doubles from a user 
at the keyboard. Save the file as Percentages2.java. 


When gasoline is $100 per barrel, then the consumer's price at the pump is between $3.50 
and $4.00 per gallon. Create a class named GasPrices. Its main() method holds an integer 
variable named pricePerBarrel to which you will assign a value entered by a user at the 
keyboard. Create a method to which you pass pricePerBarrel. The method displays the 
range of possible prices per gallon. For example, if gas is $120 per barrel, then the price at 
the pump should be between $4.20 and $4.80. Save the application as GasPrices.java. 


There are 2.54 centimeters in an inch, and there are 3.7854 liters in a U.S. gallon. 
Create a class named MetricConversion. Its main() method accepts an integer value 
from a user at the keyboard, and in turn passes the entered value to two methods. 
One converts the value from inches to centimeters and the other converts the same 
value from gallons to liters. Each method displays the results with appropriate 
explanation. Save the application as MetricConversion.java. 
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Exercises 


7. Assume that a gallon of paint covers about 350 square feet of wall space. Create an 
application with a main) method that prompts the user for the length, width, and 
height of a rectangular room. Pass these three values to a method that does the 
following: 


e Calculates the wall area for a room 173 








e Passes the calculated wall area to another method that calculates and returns the 
number of gallons of paint needed 


e Displays the number of gallons needed 


e Computes the price based on a paint price of $32 per gallon, assuming that 
the painter can buy any fraction of a gallon of paint at the same price as a 
whole gallon 


e Returns the price to the main() method 


The main() method displays the final price. For example, the cost to paint a 
15- by-20-foot room with 10-foot ceilings is $64. Save the application as 
PaintCalculator.java. 


8. The Harrison Group Life Insurance company computes annual policy premiums 
based on the age the customer turns in the current calendar year. The premium is 
computed by taking the decade of the customer’s age, adding 15 to it, and multi- 
plying by 20. For example, a 34-year-old would pay $360, which is calculated by 
adding the decades (3) to 15, and then multiplying by 20. Write an application that 
prompts a user for the current year and a birth year. Pass both to a method that 
calculates and returns the premium amount, and then display the returned amount. 
Save the application as Insurance.java. 


9. Write an application that calculates and displays the weekly salary for an employee. 
The main() method prompts the user for an hourly pay rate, regular hours, and 
overtime hours. Create a separate method to calculate overtime pay, which is regular 
hours times the pay rate plus overtime hours times 1.5 times the pay rate; return the 
result to the main() method to be displayed. Save the program as Salary.java. 


10. Write an application that calculates and displays the amount of money a user would 
have if his or her money could be invested at 5 percent interest for one year. Create a 
method that prompts the user for the starting value of the investment and returns it 
to the calling program. Call a separate method to do the calculation, and return the 
result to be displayed. Save the program as Interest.java. 













11. a. Create a class named Sandwich. Data fields include a String for the main 
ingredient (such as “tuna”), a String for bread type (such as “wheat”), and a 
double for price (such as 4.99). Include methods to get and set values for each of 
these fields. Save the class as Sandwich.java. 


b. Create an application named TestSandwich that instantiates one Sandwich object 
and demonstrates the use of the set and get methods. Save this application as 
TestSandwich.java. 
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12. a. Create a class named Student. A Student has fields for an ID number, number of 
credit hours earned, and number of points earned. (For example, many schools 
compute grade point averages based on a scale of 4, so a three-credit-hour class in 
which a student earns an A is worth 12 points.) Include methods to assign values 
to all fields. A Student also has a field for grade point average. Include a method 

174 to compute the grade point average field by dividing points by credit hours 

earned. Write methods to display the values in each Student field. Save this class 
as Student.java. 





b. Write a class named ShowStudent that instantiates a Student object from the 
class you created and assign values to its fields. Compute the Student grade point 
average, and then display all the values associated with the Student. Save the 
application as ShowStudent.java. 


c. Create a constructor for the Student class you created. The constructor should 
initialize each Student’s ID number to 9999, his or her points earned to 12, and 
credit hours to 3 (resulting in a grade point average of 4.0). Write a program that 
demonstrates that the constructor works by instantiating an object and displaying 
the initial values. Save the application as ShowStudent2.java. 


13. a. Create a class named BankAccount with fields that hold an account number, the 
owner’s name, and the account balance. Include a constructor that initializes each 
field to appropriate default values. Also include methods to get and set each of the 
fields. Include a method named deductMonth1yFee() that reduces the balance by 
$4.00. Include a static method named explainAccountPolicy() that explains 
that the $4 service fee will be deducted each month. Save the class as 
BankAccount.java. 


b. Create a class named TestBankAccount whose main() method declares four 
BankAccount objects. Call a getData() method three times. Within the method, 
prompt a user for values for each field for a BankAccount, and return a BankAccount 
object to the main() method where it is assigned to one of main()’s BankAccount 
objects. Do not prompt the user for values for the fourth BankAccount object, but let 
it continue to hold the default values. Then, in mainQ, pass each BankAccount 
object in turn to a showalues() method that displays the data, calls the method 
that deducts the monthly fee, and displays the balance again. The showValues() 
method also calls the method that explains the deduction policy. Save the 
application as TestBankAccount.java. 














14, a. Create a class named Painting that contains fields for a painting’s title, artist, 
medium (such as water color), price, and gallery commission. Create a 
constructor that initializes each field to an appropriate default value, and 
create instance methods that get and set the fields for title, artist, medium, and 
price. The gallery commission field cannot be set from outside the class; it is 
computed as 20 percent of the price each time the price is set. Save the class as 
Painting.java. 
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Exercises 


b. Create a class named TestPainting whose main() method declares three 
Painting items. Create a method that prompts the user for and accepts values 
for two of the Painting objects, and leave the third with the default values 
supplied by the constructor. Then display each completed object. Finally, display 
a message that explains the gallery commission rate. Save the application as 
TestPainting.java. 175 


ee Debugging Exercises 


1. Each of the following files saved in the Chapter03 folder in your downloadable 
student files has syntax and/or logic errors. In each case, determine and fix the 
problem. After you correct the errors, save each file using the same filename 
preceded with Fix. For example, DebugThreel java will become 








FixDebugThreel.java. 
a. DebugThreel.java 
b. DebugThree2.java 
c. DebugThree3.java 
d. DebugThree4.java 


When you change a filename, remember to change every instance of the class name within the file so that it 
matches the new filename. In Java, the filename and class name must always match. 


or, Game Zone 


1. Playing cards are used in many computer games, including versions of such classics 
as solitaire, hearts, and poker. Design a Card class that contains a character data field 
to hold a suit (s for spades, / for hearts, d for diamonds, or c for clubs) and an integer 
data field for a value from 1 to 13. (When you learn more about string handling in 
the chapter Characters, Strings, and the StringBuilder, you can modify the class to 
hold words for the suits, such as spades or hearts, as well as words for some of the 
values—for example, ace or king.) Include get and set methods for each field. Save 
the class as Card.java. 















Write an application that randomly selects two playing cards and displays their 
values. Simply assign a suit to each of the cards, but generate a random number 
for each card’s value. Appendix D contains information on generating random 
numbers. To fully understand the process, you must learn more about Java 
classes and methods. However, for now, you can copy the following statements to 
generate a random number between 1 and 13 and assign it to a variable: 


final int CARDS _IN_ SUIT = 13; 
myValue = (Cint)(Math.random(Q) * 100) % CARDS_IN SUIT + 1); 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce: reserves the right to remove additi 


CHAPTER 3 Using Methods, Classes, and Objects 


After reading the chapter Making Decisions, you will be able to have the game 
determine the higher card. For now, just observe how the card values change as you 
execute the program multiple times. Save the application as PickTwoCards.java. 


You use the Math. random() function to generate a random number. The function call uses only a class 


176 and method name—no object—so you know the random() method must be a static method. 








2. Computer games often contain different characters or creatures. For example, you 
might design a game in which alien beings possess specific characteristics such as 
color, number of eyes, or number of lives. Design a character for a game, creating a 
class to hold at least three attributes for the character. Include methods to get and 
set each of the character’s attributes. Save the file as MyCharacter.java. Then 
write an application in which you create at least two characters. In turn, pass each 
character to a display method that displays the character’s attributes. Save the 
application as TwoCharacters.java. 


Case Problems 





a. Carly’s Catering provides meals for parties and special events. In Chapter 2, 
you wrote an application that prompts the user for the number of guests 
attending an event, displays the company motto with a border, and then 
displays the price of the event and whether the event is a large one. Now 
modify the program so that the main() method contains only three executable 
statements that each call a method as follows: 


e The first executable statement calls a public static int method that 
prompts the user for the number of guests and returns the value to the 
main() method. 


e The second executable statement calls a public static void method that 
displays the company motto with the border. 


e The last executable statement passes the number of guests to a public 
static void method that computes the price of the event, displays the 
price, and displays whether the event is a large event. 












Save the file as CarlysEventPrice WithMethods.java. 
b. Create a class to hold Event data for Carly’s Catering. The class contains: 


e Two public final static fields that hold the price per guest ($35) and the 
cutoff value for a large event (50 guests) 


e Three private fields that hold an event number, number of guests for the 
event, and the price. The event number is stored as a String because Carly 
plans to assign event numbers such as M312. 
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Exercises 


e Two public set methods that set the event number (setEventNumber()) and 
the number of guests (setGuests()). The price does not have a set method 
because the setGuests() method will calculate the price as the number of 
guests multiplied by the price per guest every time the number of guests is set. 


e Three public get methods that return the values in the three nonstatic fields — 








Save the file as Event.java. 


c. Use the CarlysEventPriceWithMethods class you created in Step 1a as a starting 
point for a program that demonstrates the Event class you created in Step 1b, but 
make the following changes: 


e You already have a method that gets a number of guests from a user; now add 
a method that gets an event number. The mainQ method should declare an 
Event object, call the two data entry methods, and use their returned values to 
set the fields in the Event object. 


e Call the method from the CarlysEventPricewWithMethods class that displays 
the company motto with the border. The method is accessible because it is 
public, but you must fully qualify the name because it is in another class. 


e Revise the method that displays the event details so that it accepts the newly 
created Event object. The method should display the event number, and it 
should still display the number of guests, the price per guest, the total price, 
and whether the event is a large event. 


Save the program as EventDemo.java. 


2. a. Sammy’s Seashore Supplies rents beach equipment such as kayaks, canoes, beach 
chairs, and umbrellas to tourists. In Chapter 2, you wrote an application that 
prompts the user for the number of minutes a piece of sports equipment was 
rented, displays the company motto with a border, and displays the price for the 
rental. Now modify the program so that the main() method contains only three 
executable statements that each call a method as follows: 


e The first executable statement calls a method that prompts the user for the 
rental time in minutes and returns the value to the main() method. 


e The second executable statement calls a method that displays the company 
motto with the border. 











e The last executable statement passes the number of minutes to a method that 
computes the hours, extra minutes, and price for the rental, and then displays 
all the details. 


Save the file as SammysRentalPriceWithMethods.java. 


b. Create a class to hold Rental data for Sammy’s Seashore Supplies. The class 
contains: 


e Two public final static fields that hold the number of minutes in an hour 
and the hourly rental rate ($40) 
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e Four private fields that hold a contract number, number of hours for the 
rental, number of minutes over an hour, and the price. The contract number 
is stored as a String because Sammy plans to assign contract numbers such as 
K681. 


e Two public set methods. One sets the contract number (setContractNumber()). 
The other is named setHoursAndMi nutes (), and it accepts the number of 
minutes for the rental and then sets the hours, extra minutes over an hour, and 
the total price. Recall from Chapter 2 that the price is $40 per hour plus $1 for 
every extra minute. 
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e Four public get methods that return the values in the four nonstatic fields 
Save the file as Rental.java. 


c. Use the SammysRenta1PriceWithMethods class you created in Step 2a as a starting 
point for a program that demonstrates the Rental class you created in Step 2b, 
but make the following changes: 


e You already have a method that gets a number of minutes from a user; now 
add a method that gets a contract number. The main() method should 
declare a Rental object, call the two data entry methods, and use their 
returned values to set the fields in the Rental object. 


e From the SammysRentalPricewWithMethods class, call the RentalDemo method 
that displays the company motto with the border. The method is accessible 
because it is public, but you must fully qualify the name because it is in 
another class. 


e Revise the method that displays the rental details so that it accepts the newly 
created Rental object. The method should display the contract number, and it 
should still display the hours and minutes, the hourly rate, and the total price. 


Save the program as RentalDemo.java. 
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More Object 
Concepts 


In this chapter, you will: 


Understand blocks and scope 
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Avoid ambiguity 


(©) 


Create and call constructors with parameters 
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Use the this reference 
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Use static fields 
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Use automatically imported, prewritten constants 
and methods 
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CHAPTER 4 More Object Concepts 


Understanding Blocks and Scope 


Within any class or method, the code between a pair of curly braces is called a block. For 
example, the method shown in Figure 4-1 contains two blocks. The first block contains 
another, so it is an example of an outside block (also called an outer block). It begins 
180 immediately after the method declaration and ends at the end of the method. The second 
block is called the inside block or inner block. It is contained within the second set of 
curly braces and contains two executable statements: the declaration of anotherNumber 
and a printInQ statement. The inside block is nested, or contained entirely within, the 
outside block. 








public static void methodWithNestedBlocks() 
{ 


Outer block int aNumber = 10; aNumber comes into existence 


starts with 
opening brace System.out.printIn 
C"In outer block, aNumber is 
{ 


lanerbieek int anotherNumber = 512; anotherNumber comes into existence 


: System.out.printin 
starts with next C"In inner block, aNumber is " + 
aNumber + " and another number is " + 
anotherNumber) ; 


Inner block ends I anotherNumber ceases to exist; it goes out of scope 


System.out.printInC"In outer block, aNumber is " + aNumber); 


3 
Outer block aNumber ceases to exist; it goes out of scope 
ends 


Figure 4-1 A method with nested blocks 





+ aNumber); 


opening brace 








A block can exist entirely within another block or entirely outside and separate from 
another block, but blocks can never overlap. For example, if a method contains two 
opening curly braces, indicating the start of two blocks, the next closing curly brace 
always closes the inner (second) block—it cannot close the outer block because that 
would make the blocks overlap. Another way to state this concept is that whenever 
you encounter a closing brace that ends a block, it always closes the most recently 
opened block. 


When you declare a variable, you cannot refer to that variable outside its block. As 
you learned in Chapter 3, the portion of a program within which you can refer to a 
variable is the variable’s scope. A variable comes into existence, or comes into scope, 
when you declare it. A variable ceases to exist, or goes out of scope, at the end of the 
block in which it is declared. Although you can create as many variables and blocks as 
you need within any program, it is not wise to do so without a reason. The use of 
unnecessary variables and blocks increases the likelihood of improper use of variable 
names and scope. 
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Understanding Blocks and Scope, 


In the methodwithNestedBlocks() method shown in Figure 4-1, the variable aNumber 
exists from the point of its declaration until the end of the method. This means 
aNumber exists both in the outer block and in the inner block and can be used anywhere 
in the method. The variable anotherNumber comes into existence within the inner 
block; anotherNumber goes out of scope when the inner block ends and cannot be used 
beyond its block. Figure 4-2 shows the output when the method in Figure 4-1 is called 181 
from another method. 


@ 
f=" Command Prompt _— | 


C:\Java>java TestMethodWithNestedBlocks 
In outer block. aNumber is 18 
In inner block, aNumber 16 and another number is 512 














In outer block, aNumber is 18 


aE UT. Ba 








Figure 4-2 Output produced by application that uses methodwi thNestedB locks () 


The program that produces the output shown in Figure 4-2 is stored in the CodelnFigures folder in your 
downloadable student files. 





You cannot use a data item that is not in scope. For example, Figure 4-3 shows a 
method that contains two blocks and some shaded, invalid statements. The opening and 
closing braces for each block are vertically aligned. You are not required to vertically 
align the opening and closing braces for a block, but your programs are much easier to 
read if you do. 


| public static void methodWithInvalidStatements() 
{ 
aNumber = 75; Illegal statement; this variable has not been declared yet 
int aNumber = 22; 
aNumber = 6; : : 
anotherNumber = 489; Illegal statement; this variable has not been declared yet 


{ 
anotherNumber = 165; 5, lllegal statement; this variable still has not been declared 


int anotherNumber = 9 
anotherNumber = 2; 


in & 0: Illegal statement; this variable was declared in the inner block 
aNumber = 50; =a and has gone out of scope here | 


anotherNumber = . 


} 


aNumber = 29; Illegal statement; this variable has gone out of scope 








Figure 4-3. The methodwithInvalidStatements() method 
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CHAPTER 4 More Object Concepts 


The first assignment statement in the first, outer block in Figure 4-3, aNumber = 75;, is 

invalid because aNumber has not been declared yet. Similarly, the statements that attempt to 

assign 489 and 165 to anotherNumber are invalid because anotherNumber has not been 

declared yet. After anotherNumber is declared, it can be used for the remainder of the inner 

block, but the statement that attempts to assign 34 to it is outside the block in which 

182 anotherNumber was declared. The last shaded statement in Figure 4-3, aNumber = 29;, does 
not work because it falls outside the block in which aNumber was declared; it actually falls 
outside the entire methodWithInvalidStatements() method. 





Within a method, you can declare a variable with the same name multiple times, as long as 
each declaration is in its own nonoverlapping block. For example, the two declarations of 
variables named someVar in Figure 4-4 are valid because each variable is contained within its 
own block. The first instance of someVar has gone out of scope before the second instance 
comes into scope. 





public static void twoDeclarations() : ; ; 
Don't decl { This variable will go out of scope at the next 
ee fora { closing curly brace. 
int someVar = 7; 


.A i 
oa olen System.out.printIn(someVar) ; 


This variable is totally different from the one 
in the previous block even though their 


starts here 
only to : 
demonstrate int someVar = 845; identifiers are the same. 


ae 


scope. System.out.printIln(someVar) ; 











Figure 4-4 The twoDeclarations() method 


You cannot declare the same variable name more than once within a block, even if a 
block contains other blocks. When you declare a variable more than once in a block, you are 

attempting to redeclare the variable—an illegal action. For example, in Figure 4-5, the second 
declaration of aValue causes an error because you cannot declare the same variable twice within 
the outer block of the method. By the same reasoning, the third declaration of aValue is also 

invalid, even though it appears within a new block. The block that contains the third declaration 
is entirely within the outside block, so the first declaration of aValue has not gone out of scope. 





public static void invalidRedeclarationMethod () 
35: Invalid redeclaration of aValue because it is 
Tne in same block as the first declaration 


int anotherValue = 0; 


int aValue = 10; Invalid redeclaration of aValue; even though this 
} is a new block, this block is inside the first block 


Figure 4-5 The invalidRedeclarationMethod() 
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int aValue 
int aValue 





Understanding Blocks and Scope, 


Although you cannot declare a variable twice within the same block, you can declare a 
variable within one method of a class and use the same variable name within another method 
of the class. In this case, the variable declared inside each method resides in its own location 
in computer memory. When you use the variable’s name within the method in which it is 
declared, it takes precedence over, or overrides, any other variable with the same name in 
another method. In other words, a locally declared variable always masks or hides another 183 
variable with the same name elsewhere in the class. 








For example, consider the class in Figure 4-6. In the main() method of the OverridingVariable 
class, aNumber is declared and assigned the value 10. When the program calls firstMethodQ), a 
new variable is declared with the same name but with a different memory address and a new 
value. The new variable exists only within fi rstMethod(), where it is displayed holding the 
value 77. After fi rstMethod() executes and the logic returns to the main() method, the original 
aNumber is displayed, containing 10. When aNumber is passed to secondMethod(), a copy is 
made within the method. This copy has the same identifier as the original aNumber, but a 
different memory address. So, within secondMethod(), when the value is changed to 862 and 
displayed, it has no effect on the original variable in mainQ. When the logic returns to mainQ 
after secondMethod(), the original value is displayed again. Examine the output in Figure 4-7 to 
understand the sequence of events. 





public class OverridingVariable 


public static void main(String[] args) aNumber is declared in 
{ main(). 
int aNumber = 10; Whenever aNumber 


System.out.printInC"In mainQ), aNumber is " + aNumber); is used in main), it 
firstMethod(); retains its value of 10. 
System.out.printInC"Back in mainQ), aNumber is " + aNumber); 
secondMethod(aNumber) ; 

System.out.printInC"Back in main(Q) again, aNumber jis 





+ aNumber); 


public static void firstMethod() 
This aNumber resides at a different 
int aNumber = 77; memory address from the one in main(). 
System.out.printInC"In firstMethod(), aNumber is " _ |Itis declared locally in this method. 
+ aNumber); 
} This aNumber also resides at a different 
public static void secondMethod(int aNumber) memory address from the one inmain(). 
{ It is declared locally in this method. 
System.out.printInC"In secondMethod(), at first " + 
"aNumber is " + aNumber); 
aNumber = 862; 





System.out.printInC"In secondMethod(), after an assignment " + 
"aNumber is " + aNumber); 





Figure 4-6 The OverridingVariable class 
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i 








fy Command Prompt 


C:\Java>java OverridingvJariable 

In main), aNumber is 16 

In firstMethod¢>, aNumber is 

Back in main), aNumber is 16 

184 In secondMethod(>,. at first aNumber is 18 





In secondMethod(>. after an assignment aNumber is 862 
Back in main) again, aNumber 


C:\Java> 








Figure 4-7 Output of the OverridingVariable application 


Object-oriented programmers also use the term override when a child class contains a field or method that 
has the same name as one in the parent class. You will learn more about inheritance in the chapters 
Introduction to Inheritance and Advanced Inheritance Concepts. 





You are familiar with local names overriding names defined elsewhere. If someone in your household is 
named Eric, and someone in the house next door is named Eric, members of your household who talk about 
Eric are referring to the local version. They would add a qualifier such as Eric Johnson or Eric next door to 
refer to the nonlocal version. 


When they have the same name, variables within methods of a class override or hide the 
class’s fields. Java calls this phenomenon shadowing; a variable that hides another shadows it. 
For example, Figure 4-8 shows an Employee class that contains two instance variables and 
three void methods. The setValues() method provides values for the two class instance 
fields. Whenever the method named methodThatUsesInstanceAttributes() is used with an 
Employee object, the instance values for empNum and empPayRate are used. However, when the 
other method, methodThatUsesLocalVariables(), is used with an Employee object, the local 
variable values within the method, 33333 and 555.55, shadow the class’s instance variables. 
Figure 4-9 shows a short application that declares an Employee object and uses each method; 
Figure 4-10 shows the output. 
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Understanding Blocks and Scope, 


public class Employee 


private int empNum; 


ee This method uses the class fields. 


{ 











empNum = 111; 185 


} empPayRate = 22.22; This method also uses 
public void methodThatUsesInstanceAttributes () the class fields. 


{ 





System.out.printInC"Employee number is 
System.out.printIn("Pay rate is " 


+ empNum) ; 
+ empPayRate) ; 


} 
public void methodThatUsesLocalVariables() 


{ 


int empNum = 33333; 

double empPayRate = 555.55; 
System.out.printInC"Employee number is + empNum) ; 
System.out.printIn("Pay rate is " + empPayRate) ; 


This method uses the locally declared 
variables that happen to have the 
same names as the class fields. 








Figure 4-8 The Employee class 





public class TestEmployeeMethods 








{ 
public static void main(String[] args) 
{ 
Employee aWorker = new Employee(); 
aWorker.setValues(); 
aWorker.methodThatUsesInstanceAttributes() ; 
aWorker.methodThatUsesLocalVariables(); 
} 
} 





Figure 4-9 The TestEmployeeMethods application 





= 
f= Command Prompt 


C:\Java>java TestEmployeeMethods 
Employee number is 111 

Pay rate is 22.22 

Employee number is 33333 

Pay rate is 555.55 


C:\Java>_ 











Figure 4-10 Output of the TestEmployeeMethods application 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce: Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 4 More Object Concepts 


In the methodThatUsesLocalVariables() method in Figure 4-8, the locally declared empNum 
and empPayRate are assigned 33333 and 55.55, respectively. These local variables are said to 
be closer in scope than the variables with the same name at the top of the class that are 
shadowed. When you write programs, you might choose to avoid confusing situations that 
arise when you give the same name to a class’s instance field and to a local method variable. 
But, if you do use the same name, be aware that within the method, the method’s local 
variable overrides the instance variable. 


186 





class simply because it is the “best name” to use; in these cases, the programmer must use the this 


Programmers frequently use the same name for an instance field and a parameter to a method in the same 
YD reference, which you will learn about later in this chapter. 


It is important to understand the impact that blocks and methods have on your variables. 
Variables and fields with the same names represent different memory locations when they are 
declared within different scopes. After you understand the scope of variables, you can avoid 
many potential errors in your programs. 





Understanding Blocks and Scope 


1. Avariable ceases to exist, or goes out of scope, at the end of the block in which 
itis declared. 


2. You cannot declare the same variable name more than once within a block, even 
if a block contains other blocks. 


3. Acclass’s instance variables override locally declared variables with the same 
names that are declared within the class’s methods. 


"Sa|eURA BdULISUI S,SSEID e BPLUAAO SSID e JO 
SPOUJAW UIYJIM SajqeueA ‘aweU aes au) arey Adu] UBM “EH SI JUaWAle}s asjel sy] 


ons You Do It 


Demonstrating Scope 


In this section, you create a method with several blocks to demonstrate block scope. 
1. Start your text editor, and then open a new document, if necessary. 
2. Type the first few lines for a class named DemoB1ock: 


(continues) 
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Understanding Blocks and Scope, 


(continued) 
public class DemoBlock 


{ 
public static void main(String[] args) 


3. Adda statement that displays the purpose of the program: 187 








System.out.printIn("Demonstrating block scope") ; 


4. Onanewline, declare an integer named x, assign the value 1111 to it, and 
display tts value: 
int x=1111; 
System.out.printInC"In first block x is "+ x); 

5. Begin a new block by typing an opening curly brace on the next line. Within the 
new block, declare another integer named y, and display x and y. The value of x 
is 1111, and the value of y is 2222: 


{ 
int y = 2222; 
System.out.printIn("In second block x is " +x); 
System.out.printIn("In second block y is "+y); 
} 


6. On the next line, begin another new block. Within this new block, declare a 
new integer with the same name as the integer declared in the previous 
block; then display x and y. The value of y is 3333. Call a method named 
demoMethod(), and display x and y again. Even though you will include 
statements within demoMethod() that assign different values to x and y, the 
x and y displayed here are still 1111 and 3333: 


{ 
int y = 3333; 
System.out.printin("In third block x is " +x); 
System.out.printInC"In third block y is "+y); 
demoMethod() ; 
System.out.printInC"After method x is "+ x); 
System.out.printInC"After method block y is "+ y); 
} 


7. Ona newline after the end of the block, type the following: 
System.out.printInC"At the end x is " +x); 


This last statement in the main@ method displays the value of x, which is 
still 1111. Type a closing curly brace. 


(continues) 
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(continued) 


8. Finally, enter the following demoMethod() that creates its own x and y variables, 
assigns different values, and then displays them: 


public static void demoMethod() 


{ 
int x = 8888, y = 9999; 
System.out.printIn(C"In demoMethod x is " +x); 
System.out.printIn("In demoMethod block y is "+ y); 


} 


9. Type the final closing curly brace, and then save the file as DemoBlock.java. At 
the command prompt, compile the file by typing the command javac DemoBlock. 
java. If necessary, correct any errors, and compile the program again. 


10. Run the program by typing the 





fa 


command java DemoBlock. fy Command Prompt |e 


Your output should look like 
Figure 4-11. Make certain you —| Sagupebant-ban-tadine ted patel 


Demonstrating block scope 


understand how the values of first block x is 1441 
x and y are determined in each second block y is 2222 
line of output. third block x is 1111 
third block y is 3333 
11. To gain a more complete demoMethod block y is 9999 
| After method x is 1111 
understanding of blocks and Biter mee xt Sis 3933 
scope, change the values of At the end x is 1111 


x and y in several locations C=\Java> 
throughout the program, and 
try to predict the exact output 


before resaving, recompiling, 
and rerunning the program. Figure 4-11 Output of the DemoB lock application 








Overloading a Method 


Overloading involves using one term to indicate diverse meanings. In Java, it more specifically 
means writing multiple methods in the same scope that have the same name but different 
parameter lists. The names used in the parameter lists do not matter; the lists must differ in 
parameter type, number of parameters, or both. 


When you use the English language, you overload words all the time. When you say “open the 
door,” “open your eyes,” and “open a computer file,” you are talking about three very different 
actions using very different methods and producing very different results. However, anyone 
who speaks English fluently has no trouble understanding your meaning because the verb 
open is understood in the context of the noun that follows it. 
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Overloading Method iii 


When you overload a Java method, multiple methods share a name, and the compiler 
understands which one to use based on the arguments in the method call. For example, 
suppose you create a class method to apply a simple interest rate to a bank balance. The 
method is named calculateInterest(); it receives two double parameters—the balance and 
the interest rate—and displays the multiplied result. Figure 4-12 shows the method. 

189 








public static void calculateInterest(double bal, double rate) 


1 


double interest; 


interest = bal * rate; 
System.out.printInC"Simple interest on $" + bal + 


at + rate + "% rate is + interest); 





Figure 4-12 The calculateInterest() method with two double parameters 


When an application calls the calculateInterest() method and passes two doub1e values, 
as in calculateInterest(1000.00, 0.04), the interest is calculated correctly as 4% of 
$1000.00. 


Assume, however, that different users want to calculate interest using different argument 
types. Some users who want to indicate an interest rate of 4% might use 0.04; others might 
use 4 and assume that it means 4%. When the calculateInterest() method is called with 
the arguments 1000.00 and 0.04, the interest is calculated correctly as 40.00. When the 
method is called using 1000.00 and 4, the method works because the integer argument is 
promoted to a doub1e, but the interest is calculated incorrectly as 4000.00, which is 100 times 
too high. 


A solution for the conflicting use of numbers to represent parameter values is to overload the 
calculateInterest() method. For example, in addition to the calculateInterest() 
method shown in Figure 4-12, you could add the method shown in Figure 4-13. 





Notice the data type 


for rate. 





public static void calculateInterest(double bal, int rate) 


{ 
double interest, rateAsPercent; er 
rateAsPercent = rate / 100.0; | Png 1000 cones rate] 
interest = bal * rateAsPercent; Oulls Percent equivalent. 
System.out.printiInC"Simple interest on $" + 
bal +" at "+ rate + "% rate is "+ 
interest); 
3 





Figure 4-13 The calculateInterest() method with a doub1e parameter and an int parameter 
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are divided, the result is a truncated integer; dividing by a double 100.0 causes the result to be a double. 


In Figure 4-13, note that rateAsPercent is calculated by dividing by 100.0 and not by 100. If two integers 
Y Alternatively, you could use an explicit cast such as rateAsPercent = (double)rate / 100. 


If an application calls the method calculateInterest() using two double arguments—for 
example, calculateInterest(1000.00, 0.04)—the first version of the method, the one 
shown in Figure 4-12, executes. However, if an integer is used as the second argument in a call 
to calculateInterest(—as in calculateInterest(1000.00, 4)—the second version of 
the method, the one shown in Figure 4-13, executes. In this second example, the whole 
number rate figure is correctly divided by 100.0 before it is used to determine the interest 
earned. 
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Of course, you could use methods with different names to solve the dilemma of producing 
an accurate interest figure—for example, calculateInterestUsingDouble() and 
calculateInterestUsingInt(). However, it is easier and more convenient for 
programmers who use your methods to remember just one method name they can use in 
the form that is most appropriate for their programs. It is convenient to be able to use one 
reasonable name for tasks that are functionally identical except for the argument types that 
can be passed to them. The compiler knows which method version to call based on the 
passed arguments. 


Automatic Type Promotion in Method Calls 


In Chapter 2, you learned that Java casts variables to a unifying type when you perform 
arithmetic with unlike types. For example, when you multiply an int and a double, the 
result is a double. In a similar way, Java can promote one data type to another when you 
pass a parameter to a method. For example, if a method has a double parameter and you 
pass in an integer, the integer is promoted to a double. Recall that the order of promotion is 
double, float, long, and int. Any type in this list can be promoted to any type that 
precedes it. 


When an application contains just one version of a method, you can call the method using a 
parameter of the correct data type or one that can be promoted to the correct data type. For 
example, consider the simple method shown in Figure 4-14. 


public static void simpleMethod(double d) 
{ 


} 


System.out.printInC"Method receives double parameter") ; 





Figure 4-14 The simpleMethod() method with a double parameter 


If you write an application in which you declare doubleValue as a double variable and 
intValue as an int variable (as shown in Figure 4-15), either of the two method calls, 
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simpleMethod(doubleValue); or simpleMethod(intValue) ;, results in the output “Method 
receives double parameter”. When you call the method with the double argument, the 
method works as expected, and when you call it with an integer argument, the integer is 
cast as (or promoted to) a double. The output of the program in Figure 4-15 is shown in 
Figure 4-16. 
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public class Cal1Simp1leMethod Either a double or an 
{ F F F : : int can be sent to a 
public static void main(String[] args) method that accepts a 


{ double. 
double doubleValue = 45.67; 
int intValue = 17; 
simp 1eMethod(doub1eValue) ; 
simp leMethod(intValue) ; 





3 
public static void simpleMethod(double d) 
{ 


System.out.printInC"Method receives double parameter"); 





Figure 4-15 The Cal1SimpleMethod application that calls simp1eMethod() with a double 
and an int 





rv 
fy Command Prompt 





C:\Java>java CallSimpleMethod 
Method receives double parameter 
Method receives double parameter 


C:\Java> 











Figure 4-16 Output of the Cal1Simp1eMethod application 


exist, but the declaration void simpleMethod(int 7) did exist, then the method call 
simp1eMethod(doubleValue) ; would fail. Although an int can be promoted to a double, 
a doub1e cannot become an int. This makes sense if you consider the potential loss of information 
when a doub 1e value is reduced to an integer. 


Q Note that if the method with the declaration void simpleMethod(double d) did not 


Suppose that you add an overloaded version of simpleMethod() to the program in 
Figure 4-15. This version accepts an integer parameter, as shown in Figure 4-17. When 
you properly overload a method, you can call it providing different argument lists, and 
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the appropriate version of the method executes. Now, the output changes when you call 
simpleMethod(intValue);. Instead of promoting an integer argument to a double, the 
compiler recognizes a more exact match for the method call that uses the integer 
argument, so it calls the version of the method that produces the output “Method 


receives integer parameter”. Figure 4-18 shows the output. 
192 





public class Cal1lSimpleMethodAgain 









{ 

public static void main(String[] args) 

{ The call with an int 
double doubleValue = 45.67; argument uses the 
int intValue = 17; method that is a better 
simp 1leMethod(doubleValue) ; match when it is 


simp leMethod(intValue) ; available. 


3 
public static void simpleMethod(double d) 
{ 


System.out.printInC"Method receives double parameter"); 


3 
public static void simpleMethod(Cint d) 
{ 


System.out.printInC"Method receives integer parameter") ; 








Figure 4-17 The Cal1Simp1leMethodAgain application that calls simp1leMethod() with a 
double and an int 





G 





fa" Command Prompt 


C:\Java>java CallSimpleMethodfAgain 
Method receives double parameter 
Method receives integer parameter 


C=z\Java> 











Figure 4-18 Output of the Cal1Simp1eMethodAgain application 
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Overloading a Method 


1. When you overload Java methods, you write multiple methods with a shared 
name. 
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2. When you overload Java methods, the methods are called using different 
arguments. 


3. Instead of overloading methods, it is preferable to write methods with unique 
identifiers. 
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«ne You Do It 


Overloading Methods 


In this section, you overload methods to display dates. The date-displaying methods 
might be used by many different applications in an organization, such as those that 
schedule jobs, appointments, and employee reviews. The methods take one, two, or 
three integer arguments. If there is one argument, it is the month, and the date 
becomes the first day of the given month in the year 2014. If there are two 
arguments, they are the month and the day in the year 2014. Three arguments 
represent the month, day, and year. 


GregorianCalendar to handle dates. This exercise illustrates how some of the built-in 


Instead of creating your own class to store dates, you can use the built-in Java class 
OY GregorianCalendar class was constructed by Java's creators. 


Open a new file in your text editor. 


2. Begin the following DemoOverload Class with three integer variables to test the 
method and three calls to a displayDate() method: 


public class DemoOverload 


{ 


public static void main(String[] args) 
(continues) 
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(continued) 


int month = 6, day = 24, year = 2015; 
displayDate(month) ; 
displayDate(month, day); 
displayDate(month, day, year); 

} 


Create the following displayDate() method that requires one parameter to 
represent the month and uses default values for the day and year: 


public static void displayDateCint mm) 
{ 


} 


Create the following displayDate() method that requires two parameters to 
represent the month and day and uses a default value for the year: 


System.out.printInC"Event date " + mm+"/1/2014"); 


public static void displayDateCint mm, int dd) 
{ 


} 


Create the following displayDate() method that requires three parameters 
used as the month, day, and year: 


System.out.printInC"Event date "+mm+"/" + dd+"/2014"); 


public static void displayDateCint mm, int dd, int yy) 
{ 


} 
Type the closing curly brace for the DemoOverload Class. 


System.out.printinC"Event date "+mm+"/"+ dd+"/"+ yy); 


Save the file as DemoOverload.java. 





Compile the program, correct fi 
E eta [8 Command Prompt s/o 


any errors, recompile if 
necessary, and then execute Cz\Java>java DemoOverload 
the program. Figure 4-19 shows |» UIT msi Wage 

the output. Notice that whether | Eada aban out 

you call the displayDate() 
method using one, two, or three 
arguments, the date is displayed 
correctly because you have 
successfully overloaded the Figure 4-19 Output of the DemoOverload 
displayDate() method. application 


C2\Java>_ 
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Learning About Ambiguity 


When you overload methods, you risk creating an ambiguous situation—one in which the 
compiler cannot determine which method to use. For example, consider the following 
overloaded computeBalance() method declarations: 


public static void computeBalance(double deposit) 195 


public static void computeBalance(double withdrawal) 








If you declare a double variable named myDeposit and make a method call such as 
computeBalance(myDeposit);, you will have created an ambiguous situation. Both methods 
are exact matches for your call. You might argue that a call using a variable named myDeposit 
“seems” like it should go to the version of the method with the parameter named deposit, but 
Java makes no assumptions based on variable names. Each version of computeBalance() 
could accept a double, and Java does not presume which one you intended to use. 


Sometimes, it is hard to recognize potentially ambiguous situations. For example, consider 
the following two method declarations: 


public static void calculateInterest(int bal, double rate) 
public static void calculateInterest(double bal, int rate) 


These calculateInterest() methods have different types in their parameter lists. A call 

to calculateInterest() with an int and a double argument (in that order) executes the 
first version of the method, and a call to calculateInterest() with a double and an 

int argument executes the second version of the method. With each of these calls, the 
compiler can find an exact match for the arguments you send. However, if you call 
calculateInterest() using two integer arguments, as in calculateInterest(300, 6);, an 
ambiguous situation arises because there is no exact match for the method call. Because the 
two integers in the method call can be promoted to an integer and a double (thus matching 
the first version of the overloaded method), or to a double and an integer (thus matching the 
second version), the compiler does not know which version of the calculateInterest() 
method to use, and the program does not compile. 


The two versions of calculateInterest() could coexist if no ambiguous calls were ever 
made. An overloaded method is not ambiguous on its own—it only becomes ambiguous if 
you create an ambiguous situation. A program containing a potentially ambiguous situation 
will run problem-free if you do not make any ambiguous method calls. 


It is important to note that you can overload methods correctly by providing different 
parameter lists for methods with the same name. Methods with identical names that 
have identical parameter lists but different return types are not overloaded—they are 
illegal. 


For example, the following two methods are illegal in the same class: 


int aMethodCint x) 
void aMethod(int x) 


The compiler determines which of several versions of a method to call based on the 
arguments in the method call. If those two methods existed within a class, when the method 
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call aMethod(17) ; was made, the compiler would not know which method to execute 
because both methods take an integer parameter. 


The compiler determines which version of a method to call by the method’s signature. In Chapter 3, you 
learned that a method's signature is the combination of the method name and the number, types, and order 


196 of parameters. 





If the keyword final appears in a method’s parameter list, it is ignored when determining 
ambiguity. In other words, two methods with the headers void aMethod(int x) and void 
aMethod(final int x) are ambiguous. 


SY Y 


= Watch the video Overloading Methods. 


Learning About Ambiguity 


1. Whenitis part of the same program as void myMethod(int age, String name), 
the following method would be ambiguous: 
void myMethod(String name, int age) 


2. Whenitis part of the same program as void myMethod(int age, String name), 
the following method would be ambiguous: 
String myMethod(int zipCode, String address) 


3. Whenitis part of the same program as void myMethod(int age, String name), 
the following method would be ambiguous: 
void myMethod(int x, String y) 
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Creating and Calling Constructors with Parameters 


In Chapter 3, you learned that Java automatically provides a constructor when you create a 
class. You also learned that you can write your own constructor, and that you often do so 
when you want to ensure that fields within classes are initialized to some appropriate default 
value. In Chapter 3, you learned that the automatically provided constructor is a default 
constructor (one that does not require arguments), and you learned that you can also write a 
custom default constructor. However, when you write your own constructors, you can also 
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write versions that receive parameters. Such parameters are often used to initialize data fields 
for an object. 


For example, consider the Employee class with 
just one data field, shown in Figure 4-20. ; 

: public class Employee 
Its constructor assigns 999 to the empNum of each f 197 
potentially instantiated Employee object. Anytime private int empNum; 
an Employee object is created using a statement Employee () 
such as Employee partTimeWorker = new 
Employee() ;, even if no other data-assigning 
methods are ever used, you ensure that the 
partTimeWorker Employee, like all Employee 
objects, will have an initial empNum of 999. 








empNum = 999; 





Figure 4-20 The Employee class with 
Alternatively, you might choose to create a default constructor that initializes the 
Employee objects with initial empNum values that empNum field 

differ for each Employee. To accomplish this 

when the object is instantiated, you can pass an 

employee number to the constructor. Figure 4-21 shows an Employee class that contains a 
constructor that receives a parameter. With this constructor, an argument is passed using a 
statement such as the following: 


Employee partTimeWorker = new Employee(881) ; 


When the constructor executes, the integer 
within the constructor call is passed to 
Employee() as the parameter num, which is public class Employee 


assigned to the empNum field. t . ; 
private int empNum; 


When you create an Employee class with a EmployeeCint num) 
constructor such as the one shown in 

Figure 4-21, every Employee object you create 
must have an integer argument in its 
constructor call. In other words, with this new 
version of the class, the following statement no 
longer works: 


empNum = num; 





Figure 4-21 The Employee class with a 
constructor that accepts a value 
Employee partTimeWorker = new Employee(); 


After you write a constructor for a class, you no longer receive the automatically provided 
default constructor. If a class’s only constructor requires an argument, you must provide an 
argument for every object of the class that you create. 


Overloading Constructors 


As with any other method, you can overload constructors. Overloading constructors provides 
you with a way to create objects with different initializing arguments, or none, as needed. For 
example, in addition to using the provided constructor shown in Figure 4-21, you can create a 
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second constructor for the Employee class; 
Figure 4-22 shows an Employee class that 


public class Employee 





contains two constructors. When you use this { 

class to create an Employee object, you have the private int empNum; 

option of creating the object either with or EmployeeCint num) 
198 without an initial empNum value. When you create { ; 

an Employee object with the statement Employee } emp Nan << num 

aWorker = new Employee();, the constructor Employee() 

with no parameters is called, and the Employee { 

object receives an initial empNum value of 999. empNum = 999; 

When you create an Employee object } 





with Employee anotherWorker = new 
Employee(7677) ;, the constructor version that 
requires an integer is used, and the Figure 4-22 The Employee class that 
anotherWorker Employee receives an initial contains two constructors 

empNum of 7677. 


You can use constructor arguments to initialize 

field values, but you can also use arguments for any other purpose. For example, you could 
use the presence or absence of an argument simply to determine which of two possible 
constructors to call, yet not make use of the argument within the constructor. As long as the 
constructor parameter lists differ, the constructors are not ambiguous. 


ee 
a" Watch the video Overloading Constructors. 





Creating and Calling Constructors with Parameters 


1. A default constructor is one that is automatically created. 
When you write a constructor, it can be written to receive parameters or not. 


If a class's only constructor requires an argument, you must provide an 
argument for every object of the class that you create. 
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Creating Overloaded Constructors 199 








In this section, you create a class with overloaded constructors and demonstrate how 
they work. 


1. Open anew file in your text editor, and start the CarInsurancePolicy Class as 
follows. The class contains three fields that hold a policy number, the number 
of payments the policy holder will make annually, and the policy holder’s city 
of residence. 


public class CarInsurancePol icy 
{ 
private int policyNumber; 
private int numPayments; 
private String residentCity; 


2. Create a constructor that requires parameters for all three data fields. 


public CarInsurancePolicyCint num, int payments, String city) 


{ 
policyNumber = num; 
numPayments = payments; 
residentCity = city; 

} 


3. Suppose the agency that sells car insurance policies is in the city of Mayfield. 
Create a two-parameter constructor that requires only a policy number and 
number of payments. This constructor assigns Mayfield to residentCity. 


public CarInsurancePolicy(int num, int payments) 


{ 
policyNumber = num; 
numPayments = payments; 
residentCity = "Mayfield"; 
} 


4. Adda third constructor that requires only a policy number parameter. 
This constructor uses the default values of two annual payments and Mayfield 
as the resident city. (Later in this chapter, you will learn how to eliminate the 
duplicated assignments in these constructors.) 


public CarInsurancePolicyCint num) 


{ 
policyNumber = num; 
numPayments = 2; 
residentCity = "Mayfield"; 
} 


(continues) 
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(continued) 
5. Adda display© method that outputs all the insurance policy data: 


public void display() 





200 t 
System.out.printInC"Policy #" + policyNumber + ". " + 
numPayments + " payments annually. Driver resides in " + 
residentCity + "."); 
} 


6. Add a closing curly brace for the class. Save the file as 
CarlnsurancePolicy.java. 


7. Open a new text file to create a short application that demonstrates the 
constructors at work. The application declares three CarInsurancePolicy 
objects using a different constructor version each time. Type the following code: 


public class CreatePolicies 


{ 


public static void main(String[] args) 
{ 
CarInsurancePol icy first = new CarInsurancePol icy(123); 
CarInsurancePol icy second = new CarInsurancePol icy(456, 4); 
CarInsurancePol icy third = new CarInsurancePol icy 
(789, 12, "Newcastle"); 


8. Display each object, and add closing curly braces for the method and the class: 


first.displayQ; 
second.displayQ; 
third.displayQ; 


} 


9. Save the file as CreatePolicies.java, and then compile and test the program. 
The output appears in Figure 4-23. 





G 





faa Command Prompt 


C:\Java>java CreatePolicies 

Policy #123. 2 payments annually. Driver resides in Mayfield. 
mPolicy #456. 4 payments annually. Driver resides in Mayfield. 
Policy #789. 12 payments annually. Driver resides in Newcastle. 


C:\Java> 





Figure 4-23 Output of the CreatePolicies program 


(continues) 
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(continued) 


10. Add a fourth declaration to the CreatePolicies Class that attempts to create 
a CarInsurancePolicy object using a default constructor: 


CarInsurancePol icy fourth = new CarInsurancePolicyQ ; 201 








11. Save and compile the revised CreatePolicies program. The class does not 
compile because the CarInsurancePolicy Class does not contain a default 
constructor. Change the newly added declaration to a comment, compile the 
class again, and observe that the class now compiles correctly. 


Examining Prewritten Overloaded Methods 


In this section, you examine some builtin classes and recognize their correctly 
overloaded methods. 


1. Using a Web browser, go to the Java Web site at www.oracle.com/ 
technetwork/java/index.html, and select Java APIs and Java SE 7. 


2. Using the alphabetical list of classes, find the PrintStream class, and select it. 


Examine the list of constructors for the class, and notice that each version has a 
unique parameter list. 


4. Examine the list of methods named print and printinQ. Notice that each 
overloaded version has a unique parameter list. 


5. Using the alphabetical list of classes, find the JOptionPane Class, and select it. 


Examine the list of constructors for the class, and notice that each version has a 
unique parameter list. 


7. Examine the list of methods named showConfirmDialogQ and showInputDialogQ). 
Notice that each overloaded version has a unique parameter list. 


Learning About the this Reference 


When you start creating classes, they can become large very quickly. Besides data fields, each 
class can have many methods, including several overloaded versions. On paper, a single class 
might require several pages of coded statements. 


When you instantiate an object from a class, memory is reserved for each instance field in the 
class. For example, if a class contains 20 data fields, when you create one object from that 
class, enough memory is reserved to hold the 20 field values for that object. When you create 
200 objects of the same class, the computer reserves enough memory for 4,000 data fields—20 
fields for each of the 200 objects. In many applications, the computer memory requirements 
can become substantial. Fortunately, it is not necessary to store a separate copy of each 
variable and method for each instantiation of a class. 
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Usually, you want each instantiation of a class to have its own data fields. If an Employee class 
contains fields for employee number, name, and salary, every individual Employee object 
needs a unique number, name, and salary value. (When you want each object to share a value, 
you define the field as static; a field is not static when the value in each object can be 
unique.) However, when you create a method for a class, any object can use the same method. 
202 Whether the method performs a calculation, sets a field value, or constructs an object, the 
instructions are the same for each instantiated object. Not only would it take an enormous 
amount of memory to store a separate copy of each method for every object created from 
a class, but memory would also be wasted because you would be storing identical copies 
of methods—that is, each object’s copy of the method would have the same contents. 
Luckily, in Java just one copy of each method in a class is stored, and all instantiated objects 
can use that copy. 





When you use a nonstatic method, you use the object name, a dot, and the method name— 
for example, aWworker.getEmpNum() or anotherWorker.getEmpNum(). When you execute the 
getEmpNum() method, you are running the only copy of the method. However, within the 
getEmpNum() method, when you access the empNum field, you access a different field 
depending on the object. The compiler must determine whose copy of the empNum value 
should be returned by the single getEmpNum() method. 


The compiler accesses the correct object’s field because every time you call a nonstatic 
method, you implicitly pass a reference to the named object attached to the method call. 

A reference is an object’s memory address. The reference is implicit because it is understood 
automatically without actually being written. The reference to an object that is passed to any 
object’s nonstatic method is called the this reference; this is a reserved word in Java. Only 
nonstatic, instance methods have a this reference. For example, the two getEmpNumQ 
methods for the Employee class shown in Figure 4-24 perform identically. The first 

method simply uses the this reference without your being aware of it; the second method 
uses the this reference explicitly. Both methods return the empNum of the object used to 
call the method. 











The this reference is sent into this 
public int getEmpNum() nonstatic method as a parameter 
{ automatically; you do not (and 
return empNum; cannot) write code for it. You do not 
} need to use this with empNum. 





public int getEmpNum() 
{ 


i 


return this. empNum; 


However, you can explicitly use 
the this reference with 


empNum. The two methods in 
this figure operate identically. 





Figure 4-24 Two versions of the getEmpNum() method, with and without an explicit this reference 
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Learning About the this Reference 9) 


Frequently, you neither want nor need to refer to the this reference within the instance 
methods that you write, but the this reference is always there, working behind the scenes, so 
that the data field for the correct object can be accessed. 


On a few occasions, you must use the this reference to make your classes work correctly; one 

example is shown in the Student class in Figure 4-25. Within the constructor for this class, 203 
the parameter names stuNum and gpa are identical to the class field names. Within the 
constructor, stuNum and gpa refer to the locally declared names, not the class field names. 
The statement stuNum = stuNum accomplishes nothing—it assigns the local variable value to 
itself. The client application in Figure 4-26 attempts to create a Student object with an ID 
number of 111 and a grade point average of 3.5, but Figure 4-27 shows the incorrect output. 
The values are not assigned to the fields; instead, they are just zeroes. 











public class Student 





{ 
private int stuNum; Don't Do It 
private double gpa; All four variables used in these 
public Student Cint stuNum, double gpa) (ROR eiClitticele eile lolerIRU-lecioiome lla t-lk-\0) 
in the method's parameter list. The fields are 
stuNum = stuNum; never accessed because the local variables 
gpa = gpa, shadow the fields. These two assignment 
: : statements accomplish nothing. 
public void showStudent () 
System.out.printInC"Student #" + stuNum + 
"gpa is " + gpa); 
} 





Figure 4-25 A Student class whose constructor does not work 


public class TestStudent 
{ 


public static void main(String[] args) 


{ 


Student aPsychMajor = 
new Student(111, 3.5); 
aPsychMajor.showStudentQ) ; 





Figure 4-26 The TestStudent class that instantiates a Student object 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 4 More Object Concepts 





204 








Figure 4-27 





Output of the TestStudent application using the incorrect Student class in Figure 4-25 


One way to fix the problem with the Student class is to use different identifiers for the class's 
fields and the parameters to the constructor. However, sometimes the identifiers you have 
chosen are the best and simplest identifiers for a value. If you choose to use the same 
identifiers, you can use the this reference explicitly to identify the fields. Figure 4-28 shows a 
modified Student class. The only difference between this class and the one in Figure 4-25 is 
the explicit use of the this reference within the constructor. When the this reference is used 
with a field name in a class method, the reference is to the class field instead of to the local 
variable declared within the method. When the TestStudent application uses this new 
version of the Student class, the output appears as expected, as shown in Figure 4-29. 














1 G&G 
i Command Prompt 
uae class Student ics. P 
private int stuNum; C:\Java>java TestStudent 
private double gpa; Student #111 gpa is 3.5 
public StudentCint stuNum, double gpa) 
: C2\JdJava> 
this.stuNum = stuNum; 
this.gpa = gpa; 
} 
public void showStudent() Figure 4-29 Output of the TestStudent 
{ lication using the new version of th 
System.out.printInC"Student #" + SPOIGANON Using He wey Versi Orme 
stuNum + " gpa is " + gpa); Student class 
} 
} 


Figure 4-28 The Student class using the explicit this 


reference within the constructor 
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Learning About the this Reference) 


Using the this Reference to Make Overloaded Constructors 
More Efficient 


Suppose you create a Student class with data fields for a student number and a grade point 


average. Further suppose you want four overloaded constructors as follows: 
205 








e Aconstructor that accepts an int and a double and assigns them the student number and 
grade point average, respectively 


e A constructor that accepts a double and assigns it to the grade point average, but 
initializes every student number to 999 


e A constructor that accepts an int and assigns it to the student number, but initializes 
every grade point average to 0.0 


e A default constructor that assigns 999 to every student number and 0.0 to every grade 
point average 


Figure 4-30 shows the class. Although this class works, and allows Students to be constructed 
in four different ways, there is a lot of repetition within the constructors. 


public class Student 
{ 
private int stuNum; 
private double gpa; 
StudentCint num, double avg) 
{ 
stuNum = num; 
gpa = avg; 
} 
Student(double avg) 
{ 
stuNum = 999; 
gpa = avg; 


} 
StudentCint num) 
{ 


stuNum = num; 
gpa = 0.0; 

} 

Student Q 

{ 
stuNum = 999; 
gpa = 0.0; 





Figure 4-30 Student class with four constructors 
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You can reduce the amount of repeated code in Figure 4-30 and make the code less error- 
prone by calling one constructor version from the others. To do so, you use the this 
reference from one constructor version to call another version. Figure 4-31 shows how the 
Student class can be rewritten. 


206 





public class Student 
{ 
private int stuNum; 
private double gpa; 
StudentCint num, double avg) 
{ 
stuNum = num; 
gpa = avg; 
} 
Student(double avg) 
{ 


} 
StudentCint num) 
{ 


} 
Student (Q) 
{ 


} 


this(999, avg); 


this(num, 0.0); 


this(999, 0.0); 





Figure 4-31 The Student class using this in three of four constructors 


By writing each constructor to call one master constructor, you save coding and reduce the 
chance for errors. For example, if code is added later to ensure that all student ID numbers 
are three digits, or that no grade point average is greater than 4.0, the new code will be written 
only in the two-parameter version of the constructor, and all the other versions will use it. 
(Testing a variable to ensure it falls within the proper range of values requires decision 
making. The next chapter covers this topic.) 


Although you can use the this reference with field names in any method within a class, you 
cannot call this(@ from other methods in a class; you can only call it from constructors. 
Additionally, if you call this© from a constructor, it must be the first statement within the 
constructor. 


ee ; . 
—" Watch the video The this Reference. 
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Learning About the this Reference | 


Learning About the this Reference 


1. Usually, you want each instantiation of a class to have its own nonstatic data 207 
fields, but each object does not need its own copy of most methods. 


2. When you use a nonstatic method, the compiler accesses the correct object’s 
field because you implicitly pass an object reference to the method. 








3. The this reference is supplied automatically in classes; you cannot use it 
explicitly. 
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<n You Do It 


Using the this Reference to Make Constructors More Efficient 


In this section, you modify the CarInsurancePolicy Class so that its constructors are 
more efficient. 


1. Open the CarlnsurancePolicy.java file. Change the class name to 
CarInsurancePolicy2, and immediately save the file as 
CarlInsurancePolicy2.java. 


2. Change the name of the three-parameter constructor from 
CarInsurancePolicy() tO CarInsurancePolicy2Q). 


3. Replace the constructor that accepts a single parameter for the policy 
number with the following constructor. The name of the constructor is 
changed from the earlier version, and this one passes the policy number and 
two constant values to the three-parameter constructor: 


public CarInsurancePolicy2(Cint num) 


{ 
this(num, 2, "Mayfield"); 


: (continues) 
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10. 


(continued) 


Replace the constructor that accepts two parameters (for the policy number 
and number of payments) with the following constructor. This constructor has a 
new name and passes the two parameters and one constant value to the 
three-parameter constructor: 


public CarInsurancePolicy2(Cint num, int payments) 


{ 


} 
Save the file, and compile it. 


this(num, payments, "Mayfield"); 


Open the CreatePolicies.java file that demonstrates the use of the different 
constructor versions. Change the class name to CreatePolicies2, and save the 
file as CreatePolicies2.java. 


Add the digit 2 in six places—three times to change the class name 
CarInsurancePolicy tO CarInsurancePol icy2 when the name is used as a 
data type, and in the three constructor calls. 


Save the file, and then compile and execute it. The output is identical to that 
shown in Figure 4-23 in the previous “You Do It” section, but the repetitious 
constructor code has been eliminated. 


You can further reduce the code in the CarInsurancePolicy Class by changing 
the single-parameter constructor to the following, which removes the constant 
"Mayfield" from the constructor call: 


public CarInsurancePol icy2(Cint num) 


{ 


} 


Now, the single-parameter version calls the two-parameter version and passes 
the policy number and the constant 2. In turn, the two-parameter version calls 
the three-parameter version, adding "Mayfield" as the city. 


this(num, 2); 


Save this version of the CarInsurancePolicyz Class, and compile it. Then recompile 
the CreatePolicies2.java file, and execute it. The output remains the same. 


Using static Fields 


In Chapter 3, you learned that methods you create to use without objects are static. For 
example, the main© method in a program and the methods that mainQ calls without an 
object reference are static. You also learned that most methods you create within a class from 
which objects will be instantiated are nonstatic. Static methods do not have a this reference 
because they have no object associated with them; therefore, they are called class methods. 
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You can also create class variables, which are variables that are shared by every 
instantiation of a class. Whereas instance variables in a class exist separately for every 
object you create, there is only one copy of each static class variable per class. For 
example, consider the Basebal1Player class in Figure 4-32. The Basebal1Player class 
contains a shaded static field named count, and two nonstatic fields named number 
and battingAverage. The Basebal1Player constructor sets values for number and 209 
battingAverage and increases the count by one. In other words, every time a 
Basebal1Player object is constructed, it contains individual values for number and 
battingAverage, and the count field contains a count of the number of existing objects 

and is shared by all Basebal1Player objects. 








public class Basebal1Player 
{ 
private static int count = 0; 
private int number; 
private double battingAverage; 
public BaseballPlayer(Cint id, double avg) 
{ 


number = id; 
battingAverage = avg; 


count = count + 1; 
} 
public void showPlayer() 
{ 
System.out.printInC("Player #" + number + 
" batting average is " + battingAverage + 
"There are " + count + " players"); 





Figure 4-32 The Basebal1Player class 


The showPlayer() method in the Basebal1Player class displays a Basebal1Player’s 
number, batting average, and a count of all current players. This method is not static—it 
accesses an individual object’s data. Methods declared as static cannot access instance 
variables, but instance methods can access both static and instance variables. 


The TestPlayer class in Figure 4-33 is an application that declares two Basebal1Player 
objects, displays them, and then creates a third Basebal1Player object and displays it. When 
you examine the output in Figure 4-34, you can see that by the time the first two objects are 
declared, the count value that they share is 2. Whether count is accessed using the aCatcher 
object or the aShortstop object, the count is the same. After the third object is declared, its 
count value is 3, as is the value of count associated with the previously declared aCatcher 
object. In other words, because the static count variable is incremented within the class 
constructor, each object has access to the total number of objects that currently exist. No 
matter how many Basebal1Player objects are eventually instantiated, each refers to the 
single count field. 
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public class TestPlayer 
{ 
public static void main(String[] args) 
{ 
Basebal]Player aCatcher = new BaseballPlayer(12, .218); 
Basebal]Player aShortstop = new BaseballPlayer(31, .385); 


aCatcher.showPlayer() ; 

aShortstop.showPlayer() ; 

Basebal1lPlayer anOutfielder = new BaseballPlayer(44, .505); 
anOutfielder.showPlayer(); 

aCatcher.showPlayer() ; 





Figure 4-33 The TestPlayer class 


rn 
werner 


C:\Java>java TestPlayer 

Player #12 batting average i A. There are 2 players 
Player #31 batting average is ss There are players 
Player #44 hatting average _ There are 3 players 
Player #12 batting average is 6.218 There are 3 players 








C:\Java>_ 











Figure 4-34 Output of the TestPlayer application 


Using Constant Fields 


In Chapter 2, you learned to create named constants by using the keyword final. 
Sometimes a data field in a class should be constant. For example, you might want to 
store a school ID value that is the same for every Student object you create, so you 
declare it to be static. In addition, if you want the value for the school ID to be fixed so 
that all Student objects use the same ID value—for example, when applying to 
scholarship-granting organizations or when registering for standardized tests—you might 
want to make the school ID unalterable. As with ordinary variables, you use the keyword 
final with a field to make its value unalterable after construction. For example, the class 
in Figure 4-35 contains the symbolic constant SCHOOL_ID. Because it is static, all objects 
share a single memory location for the field, and because it is final, it cannot change 
during program execution. 


ight to remove additional content at any time if subsequent rights restrictions require it. 





public class Student 

{ 
private static final int SCHOOL_ID = 12345; 
private int stuNum; 
private double gpa; 211 
public Student(int stuNum, double gpa) 
{ 








this.stuNum = stuNum; 


this.gpa = gpa; 


fF 
public void showStudent() 
{ 
System.out.printInC"Student #" + stuNum + 
"gpa is " + gpa); 





Figure 4-35 The Student class containing a symbolic constant 


A nonstatic fina] field’s value can be set in the class constructor. For example, you can set it 
using a constant, or you can set it using a parameter passed into the constructor. However, 

a static final field’s value must be set at declaration, as in the Student class example in 
Figure 4-35. This makes sense because there is only one static field stored for every object 
instantiated. 


G 
G 


You can use the keyword final with methods or classes as well as with fields. When used in this manner, 
final indicates limitations placed on inheritance. You will learn more about inheritance in the chapters 
Introduction to Inheritance and Advanced Inheritance Concepts. 


Fields that are Final also can be initialized in a static initialization block. For more details about this 
technique, see the Java Web site. 


Fields declared to be static are not always final. Conversely, final fields are not always 
static. In summary: 


e Ifyou want to create a field that all instantiations of the class can access but the field value 
can change, then it is static but not final. For example, in the last section you saw a 
nonfinal static field in the Basebal1Player class that held a changing count of all 
instantiated objects. 


e Ifyou want each object created from a class to contain its own final value, you would 
declare the field to be final but not static. For example, you might want each 
Basebal1Player object to have its own, nonchanging date of joining the team. 


e If you want all objects to share a single nonchanging value, then the field is static and 
final. 
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Using static Fields 


212 1. Methods declared as static receive a this reference that contains a reference 
to the object associated with them. 





Methods declared as static are called class methods. 
3. A final static field's value is shared by every object of a class. 
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<n You Do It 


Using Static and Nonstatic final Fields 


In this section, you create a class for the Riverdale Kennel Club to demonstrate the use 
of static and nonstatic final fields. The club enters its dogs in an annual triathlon event 
in which each dog receives three scores in agility, conformation, and obedience. 


1. Open a new file in your text editor, and enter the first few lines for a 
DogTriathlonParticipant Class. The class contains a final field that holds 
the number of events in which the dog participated. Once a final field is set, 
it never should change. The field is not static because it is different for each 
dog. The class also contains a static field that holds the total cumulative 
score for all the participating dogs. The field is not final because its value 
increases as each dog participates in the triathlon, but it is static because at 
any moment in time, it is the same for all participants. 


public class DogTriathlonParticipant 
{ 
private final int NUM_EVENTS; 
private static int totalCumulativeScore = 0; 


2. Add six private fields that hold the participating dog’s name, the dog’s score in 
three events, the total score, and the average score: 


private String name; 

private int obedienceScore; 
private int conformationScore; 
private int agilityScore; 
private int total; 

private double avg; 


(continues) 
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(continued) 


3. The constructor for the class requires five parameters—the dog’s name, the 
number of events in which the dog participated, and the dog’s scores in the 
three events. (After you read the chapter on decision making, you will be able 213 
to ensure that the number of nonzero scores entered matches the number of 
events, but for now no such checks will be made.) The constructor assigns 
each value to the appropriate field. 








public DogTriathlonParticipant(String name, 
int numEvents, int scorel, int score2, int score3) 


{ 


this.name = name; 
NUM_EVENTS = numEvents; 
obedienceScore = scorel; 
conformationScore = score2; 
agilityScore = score3; 

4. After the assignments, the constructor calculates the total score for the 
participant and the participant’s average score. Notice the result of the division 
is cast to a double so that any fractional part of the calculated average is not 
lost. Also, add the participant’s total score to the cumulative score for all 
participants. Recall that this field is static because it should be the same for all 
participants at any point in time. After these statements, add a closing curly 
brace for the constructor. 


total = obedienceScore + 
conformationScore + agilityScore; 
avg = (double) total / NUM_EVENTS; 
totalCumulativeScore = totalCumulativeScore + 
total; 
} 


5. Start a method that displays the data for each triathlon participant. 
public void displayQ 


{ 
System.out.printIn(name + " participated in " + 
NUM_EVENTS + 
" events and has an average score of " + avg); 
System.out.printIin(" "+ name + 
" has a total score of " + total + 
" bringing the total cumulative score to " + 
totalCumulativeScore) ; 
} 


6. Add a closing curly brace for the class. Then, save the file as 
DogTriathlonParticipant.java. Compile the class, and correct any errors. 


(continues) 
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(continued) 


7. Open a new file in your text editor, and then enter the header and 
opening and closing curly braces for a class you can use to test the 
214 DogTriathlonParticipant Class. Also include a main® method header and 
its opening and closing braces. 





public class TestDogs 


{ 
public static void main(String[] args) 
{ 
z 

} 


8. Between the braces of the main® method, declare a DogTriathlonParticipant 
object. Provide values for the participant’s name, number of events, and three 
scores, and then display the object. 


DogTriathlonParticipant dogl = 
new DogTriathlonParticipant("Bowser", 2, 85, 89, 0); 
dogl.displayQ; 


9. Create and display two more objects within the main@ method. 


DogTriathlonParticipant dog2 = 

new DogTriathlonParticipant("Rush", 3, 78, 72, 80); 
dog2.displayQ; 
DogTriathlonParticipant dog3 = 

new DogTriathlonParticipant("Ginger", 3, 90, 86, 72); 
dog3.displayQ; 


10. Save the file as TestDogs.java. Compile and execute the program. The output 
looks like Figure 4-36. Visually confirm that each total, average, and cumulative 
total is correct. 





a = 


[x8 Command Prompt 2/8 






C:\Java>java TestDogs 
Bowser participated in 2 events and has an average score of 87.8 
Bowser has a total score of 174 bringing the total cumulative score to 174 
Rush participated in 3 events and has an average score of 76.66666666666667 
Rush has a total score of 230 bringing the total cumulative score to 404 
Ginger participated in 3 events and has an average score of 82.66666666666667 
Ginger has a total score of 248 bringing the total cumulative score to 652 


C=\dava> 








Figure 4-36 Output of the TestDogs program 


(continues) 
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Using Automatically Imported, Prewritten Constants and Methods) 


(continued) 


11. Experiment with the DogTriathlonParticipant Class and its test class. For 
example, try the following: 


e Add anew statement at the end of the TestDogs class that again displays the 
data for any one of the participants. Note that as long as no new objects are 
created, the cumulative score for all participants remains the same no 
matter which participant uses it. 
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e Try to assign a value to the NUM_EVENTS constant from the displayO 
method, and then compile the class and read the error message generated. 


e Remove the keyword static from the definition of totalCumulativeScore in 
the DogTriathlonParticipant Class, and then recompile the classes and run 
the program. Notice in the output that the nonstatic cumulative score no 
longer reflects the cumulative score for all objects but only the score for the 
current object using the displayQ method. 


e Use 0 as the number of events for an object. When the participant’s average 
is calculated, the result is not numeric, and NaN is displayed. NaN is an 
acronym for Not a Number. In the next chapter, you will learn to make 
decisions, and then you can prevent the NaN output. 


Using Automatically Imported, Prewritten 
Constants and Methods 


Often, you need to create classes from which you will instantiate objects. You can create 

an Employee class with fields appropriate for describing employees in your organization and 
their functions, and an Inventory class with fields appropriate for whatever type of item you 
manufacture. However, many classes are commonly used by a wide variety of programmers. 
Rather than have each Java programmer “reinvent the wheel,” the creators of Java have 
produced hundreds of classes for you to use in your programs. 


You have already used several of these prewritten classes; for example, you have used the 
System and JOptionPane classes to produce output. Each of these classes is stored in a 
package, or a library of classes, which is simply a folder that provides a convenient grouping 
for classes. Many Java packages are available only if you explicitly name them within your 
program; for example, when you use JOptionPane, you must import the javax.swing 
package into your program. However, the group that contains classes such as System is used 
so frequently that it is available automatically to every program you write. The package that is 
implicitly imported into every Java program is named java. lang. The classes it contains are 
fundamental classes, or basic classes, as opposed to the optional classes that must be named 
explicitly. Some references list a few other Java classes as also being “fundamental,” but the 
java.lang package is the only automatically imported, named package. 
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The class java. 1ang.Math contains constants and methods that you can use to perform 
common mathematical functions. All of the constants and methods in the Math class are 
static—they are class variables and class methods. For example, a commonly used constant 
is PI. In geometry, pi is an approximation of a circle’s radius based on the ratio of the 
circumference of the circle to its diameter. Within the Math class, the declaration for PI is as 
216 follows: 


public final static double PI = 3.14159265358979323846; 





Notice that PT is: 

e public, so any program can access it directly 

e final, so it cannot be changed 

e static, so only one copy exists and you can access it without declaring a Math object 
e double, so it holds a floating-point value 


You can use the value of PI within any program you write by referencing the full package path 
in which PI is defined; for example, you can calculate the area of a circle using the following 
statement: 


areaOfCircle = java.lang.Math.PI * radius * radius; 


However, the java. lang package is imported automatically into your programs, so if you 
simply reference Math. PI, Java recognizes this code as a shortcut to the full package path. 
Therefore, the preferred (and simpler) statement is the following: 


areaOfCircle = Math.PI * radius * radius; 


In addition to constants, many useful methods are available within the Math class. 

For example, the Math.max() method returns the larger of two values, and the method 
Math.abs() returns the absolute value of a number. Table 4-1 lists some common 
Math class methods. 


Method Value That the Method Returns 

abs (x) Absolute value of x 

acos (x) Arc cosine of x 

asin(x) Arc sine of x 

atan(x) Arc tangent of x 

atan2(x, y) Theta component of the polar coordinate (r, theta) that corresponds to the 
Cartesian coordinate x, y 

ceil (x) Smallest integral value not less than x (ceiling) 

cos (x) Cosine of x 


16\)(3255 Common Math class methods (continues) 
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(continued) 

Method Value That the Method Returns 

exp (x) Exponent, where x is the base of the natural logarithms 

Floor(x) Largest integral value not greater than x 217 

log(x) Natural logarithm of x 

max(x, y) Larger of x and y 

min(x, y) Smaller of x and y 

pow(x, y) x raised to the y power 

random() Random double number between 0.0 and 1.0 

rint(x) Closest integer to x (x is a double, and the return value is expressed as a 
doub1e) 

round(x) Closest integer to x (where x is a float or double, and the return value is 
an int or long) 

sin) Sine of x 

sqrt (x) Square root of x 

tan(x) Tangent of x 


1\)(3259) Common Math class methods 


Because all constants and methods in the Math class are classwide (that is, static), there is no 
need to create an instance of the Math class. You cannot instantiate objects of type Math 
because the constructor for the Math class is private, and your programs cannot access the 
constructor. 


unless you understand their purposes. For example, because the square root of a negative number is 
undefined, if you display the result after the method call imaginaryNumber = Math.sqrt(-12);, 
you see NaN. 


Q Unless you are a mathematician, you won't use many of these Math class methods, and it is unwise to do so 


Importing Classes That Are Not Imported Automatically 


Java contains hundreds of classes, only a few of which—those in the java. lang package—are 
included automatically in the programs you write. To use any of the other prewritten classes, 
you must use one of three methods: 


e Use the entire path with the class name. 
e Import the class. 


e Import the package that contains the class you are using. 
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In its java.util package, Java includes a GregorianCalendar class that is useful when 
working with dates and time. The Gregorian calendar is used in most of the world; it 
was instituted on October 15, 1582, and is named for Pope Gregory XIII, who was 
instrumental in the calendar’s adoption. (For dates that fall before the Gregorian cutover 
date, the GregorianCalendar class uses the Julian calendar, which simply uses a different 
218 leap-year rule.) 





You have seen examples in this book in which the JOptionPane and Scanner classes were 
imported so you could use their methods. Similarly, you can import the java.util class 
package, which includes the GregorianCalendar class. 


You can instantiate an object of type GregorianCalendar from this class by using the full 
class path, as in the following: 


java.util.GregorianCalendar myAnniversary = new java.util.GregorianCalendar() ; 


Alternatively, when you include import java.util.GregorianCalendar; as the first line in 
your program, you can shorten the declaration of myAnniversary to this: 


GregorianCalendar myAnniversary = new GregorianCalendar(); 


An alternative to importing a class is to import an entire package of classes. You can use the 
asterisk ( * ) as a wildcard symbol, which indicates that it can be replaced by any set of 
characters. In a Java import statement, you use a wildcard symbol to represent all the classes 
in a package. Therefore, the following statement imports the GregorianCalendar class and 
any other java.util classes as well: 


import java.util.*; 


The import statement does not move the entire imported class or package into your program, 
as its name implies. Rather, it simply notifies the program that you will use the data and 
method names that are part of the imported class or package. There is no disadvantage to 
importing an entire package instead of just the classes you need, and you will commonly see 
the wildcard method in professionally written Java programs. However, you have the 
alternative of importing each class you need individually. Importing each class by name, 
without wildcards, can be a form of documentation; this technique specifically shows which 
parts of the package are being used. 


You cannot use the Java-language wildcard exactly like a DOS or UNIX wildcard because you 
cannot import all the Java classes with import java.*;. The Java wildcard works only with 
specific packages such as import java.util.*; or import java.lang.*;. Also, note that the 
asterisk in an import statement imports all of the classes in a package, but not other packages 
that are within the imported package. 


Your own classes are included in applications without import statements because of your classpath 
GY settings. See Appendix A for more information on classpath. 
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Using the GregorianCalendar Class 


Seven constructors are available for GregorianCalendar objects. These constructors are 
overloaded, requiring different argument lists when they are called. The default constructor 
for the GregorianCalendar class creates a calendar object containing the current date and 
time in the default locale (time zone) that has been set for your computer. You can use other 219 
constructors to specify: 








e year, month, date 

e year, month, date, hour, minute 

e year, month, date, hour, minute, second 

e Locale 

e TimeZone 

e TimeZone, Locale 

You can create a default GregorianCalendar object with a statement such as the following: 


GregorianCalendar today = new 
GregorianCalendar(); 


Alternatively, you can create a GregorianCalendar object using one of the overloaded 
constructors—for example: 


GregorianCalendar myGraduationDate = new 
GregorianCalendar(2014,5,24); 


Specific data field values, such as the day, month, and year, can be retrieved from a 
GregorianCalendar object by using the get() method and specifying what you want as an 
argument. You could retrieve the day of the year (for example, February 1 is the 32nd day of 
the year) with the following statement: 


int dayOfYear = today.get(GregorianCalendar.DAY_OF_YEAR) ; 


The GregorianCalendar get() method always returns an integer. Some of the possible 
arguments to the get() method are shown in Table 4-2. In particular, notice that the month 
values in the GregorianCalendar class range from 0 through 11. Thus, January is month 0, 
February is month 1, and so on. 


As an example of how to use a GregorianCalendar object, Figure 4-37 shows an 
AgeCalculator application. In this class, a default GregorianCalendar object named now is 
created. The user is prompted for a birth year, the current year is extracted from the now 
object using the get© method, and the user’s age this year is calculated by subtracting the 
birth year from the current year. Figure 4-38 shows the output when a user born in 1986 runs 
the application in 2014. 
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Arguments Values Returned by get() 
DAY_OF_YEAR A value from 1 to 366 
DAY_OF_MONTH A value from 1 to 31 
220 DAY_OF_WEEK SUNDAY, MONDAY, ... SATURDAY, corresponding to values from 1 to 7 
YEAR The current year; for example, 2012 
MONTH JANUARY, FEBRUARY, ... DECEMBER, corresponding to values from 0 to 11 
HOUR A value from 1 to 12; the current hour in the A.M. or P.M. 
AM_PM A.M. or P.M., which correspond to values from 0 to 1 
HOUR_OF_DAY A value from 0 to 23 based on a 24-hour clock 
MINUTE The minute in the hour, a value from 0 to 59 
SECOND The second in the minute, a value from 0 to 59 
MILLISECOND The millisecond in the second, a value from 0 to 999 


We) ~=Some possible arguments to and returns from the Gregori anCalendar get () method 


import java.util.*; 
import javax.swing.*; 
public class AgeCalculator 
{ 
public static void main(String[] args) 
{ 
GregorianCalendar now = new GregorianCalendar(Q); 
int nowYear; 
int birthYear; 
int yearsOld; 


birthYear = Integer.parseInt 

(JOptionPane. showInputDialog(null, 

"In what year were you born?")); 
nowYear = now.get(GregorianCalendar. YEAR) ; 
yearsOld = nowYear - birthYear; 
JOptionPane.showMessageDialog(null, 


"This is the year you become 
"years old"); 


+ yearsOld + 





Figure 4-37 The AgeCalculator application 


The parseInt() method is used in the application in Figure 4-37 to convert the user’s input string to an 
Y integer. You learned about the parseInt() method in Chapter 2. 
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@ This is the year you become 28 years old 
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Figure 4-38 Execution of the AgeCalculator application 
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1. The creators of Java have produced hundreds of classes for you to use in your 
programs. 


Java packages are available only if you explicitly name them within your program. 
The implicitly imported java. lang package contains fundamental Java classes. 


‘payodu Ayjeonewoyne aye syaujo Ing ‘Wwessold UNOA ulUjIM Way} aweuU 
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aN You Do It 


In this section, you learn more about using the GregorianCalendar class. 


Using the Java Web Site 


1. Using a Web browser, go to the Java Web site, and select Java APIs and 
Java SE 7. Using the alphabetical list of classes, find the GregorianCalendar 
class and select it. 


2. Notice that java.util is cited at the top of the description, indicating that it is 
the containing package. 


3. Read the history and background of the GregorianCalendar Class to get an idea 
of how many issues are involved in determining values like the first day of the 
week and a week’s number ina year. Then read the rest of the documentation to 
get a feel for the fields and methods that are available with the class. 


(continues) 
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(continued) 
Using an Explicitly Imported, Prewritten Class 


Next, you construct a program using the GregorianCalendar Class and some of the 


Sau arguments to the GregorianCalendar get() method. 





1. Open a new file in your text editor. For the first line in the file, type the following: 
import java.util .*; 


2. Onthe next lines, begin the class by typing the class header, the opening brace, 
the main© method header, and its opening brace, as follows: 


public class CalendarDemo 
{ 
public static void main(String[] args) 


{ 


3. Declare a GregorianCalendar object named now that holds information about 
the current date and time. Then create a series of output statements that display 
a variety of GregorianCalendar fields containing information about the date: 


GregorianCalendar now = new GregorianCalendar() ;5 
System.out.printInC"YEAR: " + now.get(Calendar.YEAR)) ; 
System.out.print]nC"MONTH: " + now.get (Calendar .MONTH) ) ; 
System.out.print]nC"WEEK_OF_YEAR: " + 

now. get (Calendar .WEEK_OF_YEAR)) ; 
System.out.print]nC"WEEK_OF_MONTH: " + 

now. get (Calendar .WEEK_OF_MONTH)) ; 
System.out.printInC"DATE: " + now.get(Calendar.DATE)); 
System.out.print]nC"DAY_OF_MONTH: " + 

now. get (Calendar .DAY_OF_MONTH)) ; 
System.out.printinC"DAY_OF_YEAR: " + 

now. get (Calendar .DAY_OF_YEAR)); 
System.out.printinC"DAY_OF_WEEK: " + 

now. get (Calendar .DAY_OF_WEEK)); 


4. Add more statements that display information about the current time, as follows: 


System.out.printinC"AM_PM: "+ 

now. get(Calendar.AM_PM)); 
System.out.printInC"HOUR: " + now.get(Calendar.HOUR)) ; 
System.out.print]nC"HOUR_OF_DAY: " + 

now. get (Calendar .HOUR_OF_DAY)); 
System.out.printInC"MINUTE: " + 

now. get (Calendar .MINUTE)) ; 
System.out.printInC'"'SECOND: " + 

now. get (Calendar .SECOND)) ; 
System.out.printInC"MILLISECOND: " + 

now. get (Calendar .MILLISECOND)) ; 


5. Add the closing curly brace for the main() method and the closing curly brace 
for the class. 


(continues) 
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(continued) 


6. Save the file as r = 
. 5 [x8 Command Prompt rox) . 


CalendarDemo.java. Compile - 
and execute the program. 














e C:\Java>java CalendarDemo 
Figure 4-39 shows the output ea 223 
from the program when it is WEEK_OF YEAR: 14 
: MWEEK_OF_MONTH: 1 
executed a little before 10 a.m. DATE: 3 
on Thursday, April 3, 2014. AYO REAR. 93 
Notice that although people ae 


usually think of April as 
month 4, the month in the 


a | 


output is 3—the month values MILLISECOND: 824 
in the GregorianCalendar are C:\Java> 
O through 11. When you display 








month values in your own ——<—— } 


programs, you might choose . 
‘ol ARE ILA a 0A bID DRAG Figure A 39 Output of the CalendarDemo 
application 


displaying it, so that users see 
month numbers to which they are accustomed. 


Creating an Interactive Application with a Timer 


Next, you use the GregorianCalendar Class to create an application that outputs a 
user's response time to a question. 


1. Opena new file in your text editor, and type the following two import statements. 
You need the JOptionPane class to use the showConfirmDialog() method, and 
you need the java.util package to use the GregorianCalendar Class: 


import javax.swing.JOptionPane; 
import java.util .*; 


2. Begin the DialogTimer application as follows. Declare variables named mi1141, 
mil1i2, seci, and sec2. These are used to compute time1 and time2 from 
calendar objects created at the beginning and end of the program. You then use 
timel and time2 to compute a timeDifference. Also declare a constant to hold 
the number of milliseconds in a second. 


public class Dialoglimer 
{ 
public static void main(String[] args) 
{ 
int timel, time2, millil, mil1i2, secl, 
sec2, timeDifference; 
final int MILLISECS_IN_SECOND = 1000; ; 
(continues) 
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(continued) 
Instantiate a GregorianCalendar object, and retrieve its MILLISECOND and 
SECOND values. Compute a time1 value by multiplying the current seci1 value by 
1000 and adding it to the current mi11i1 value: 


GregorianCalendar before = new GregorianCalendar() ; 
millil = before. get (GregorianCal endar .MILLISECOND) ; 
secl = before. get (GregorianCal endar . SECOND) ; 

timel = MILLISECS IN SECOND * secl + mil1il; 


Display a dialog box that asks the user to make a difficult choice: 


JOptionPane. showConfirmDialog 
(null, "Is stealing ever justified? "); 


Next, create a new GregorianCalendar object. This statement does not execute 
until the user provides a response for the dialog box, so the time variables 
contain different values from the first GregorianCalendar object created: 


GregorianCalendar after = new GregorianCalendar(); 
mil1i2 = after. get(GregorianCalendar .MILLISECOND) ; 
sec2 = after. get(GregorianCal endar .SECOND) ; 

time2 = MILLISECS IN SECOND * sec2 + mi1l1i2; 


Compute the difference between the times, and display the result in a dialog box. 


timeDifference = time2 - timel; 
JOptionPane.showMessageDialog(null, "It took " + 
timeDifference + " milliseconds for you to answer"); 


Add two closing curly braces—one for the method and the other for the 
class—and then save the file as DialogTimer.java. 


Compile and execute the 

program. When the question —— 

appears, choose a response. : 

The second output looks like @ It took 10920 milliseconds for you to answer 
Figure 4-40; the actual time 
displayed varies depending 

on how long you wait before 
selecting an answer. 











Figure 4-40 Output of the DialogTimer 
The output in the DialogTimer application 


application is accurate only when 

the first and second GregorianCalendar objects are created during the 

same minute. For example, if the first object is created a few seconds before 
a new minute starts, and the second object is created a few seconds after the 
new minute starts, the second SECOND value appears to be much lower than 
the first one. On your own, modify the DialogTimer application to rectify this 
discrepancy. Save the file as DialogTimer2.java. 
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Understanding Composition and Nested Classes 


Two of the ways that you can group classes are by using composition and by nesting classes. 
This section takes a brief look at both concepts. 


225 








Composition 


The fields in a class can be simple data types like int and double, but they can also be class 
types. Composition describes the relationship between classes when an object of one class is a 
data field within another class. You have already studied many classes that contain String 
object fields. These classes employ composition. 


When you use an object as a data member of another object, you must remember to supply 
values for the contained object if it has no default constructor. For example, you might 
create a class named NameAndAddress that stores name and address information. Such a 
class could be used for employees, customers, students, or anyone else who has a name and 
address. Figure 4-41 shows a NameAndAddress class. The class contains three fields, all of 
which are set by the constructor. A display() method displays the name and address 
information on three lines. 


public class NameAndAddress 
{ 
private String name; 
private String address; 
private int zipCode; 
public NameAndAddress(String nm, String add, int zip) 
{ 
name = nm; 
address = add; 


zipCode Zip; 


} 

public void displayQ 

{ 
System.out.printIn(name) ; 
System.out.printIn(address) ; 
System.out.printIn(zipCode) ; 

} 





Figure 4-41 The NameAndAddress class 


Suppose you want to create a Schoo] class that holds information about a school. Instead of 
declaring fields for the School’s name and address, you could use the NameAndAddress class. 
The relationship created is sometimes called a has-a relationship because one class “has an” 
instance of another. Figure 4-42 shows a School class that declares and uses a 
NameAndAddress object. 
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oo public class School 


{ 
as private NameAndAddress nameAdd; 
private int enrollment; 
public School(String name, String add, int zip, int enrolled) 
This statement calls the { 
constructor in the nameAdd = new NameAndAddress(name, add, zip); 
NameAndAddress enrollment = enrolled; 
class. 
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t 
public void display() 
{ 


This statement calls the System.out.printInC"The school information:") ; 
display( method in nameAdd.displayQ ; ; 
the NameAndAddress System.out.printInC"Enrollment is 
Class. } 


} 


+ enrollment); 











Figure 4-42 The School class 


As Figure 4-42 shows, the School constructor requires four parameters. Within 

the constructor, three of the items—the name, address, and zip code—are passed to 
the NameAndAddress constructor to provide values for the appropriate fields. The fourth 
constructor parameter (the school’s enrollment) is assigned to the School class 
enrollment field. 


In the School class display method, the NameAndAddress object’s display() method is 
called to display the school’s name and address. The enrollment value is displayed 
afterward. Figure 4-43 shows a simple program that instantiates one School object. 
Figure 4-44 shows the execution. 


public class SchoolDemo 

{ 
public static void main(String[] args) 
{ 


School mySchool = new School 


C"Audubon Elementary", 
"3500 Hoyne", 60618, 350); 
mySchool .displayQ ; 





Figure 4-43 The SchoolDemo program 
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x8 Command Prompt =" a 





C:\Java>java SchoolDemo 
The school information: 


: 227 
Enrollment is 356 








C:\Java>_ 





Figure 4-44 Output of the SchoolDemo program 


Nested Classes 


Every class you have studied so far has been stored in its own file, and the filename has always 
matched the class name. In Java, you can create a class within another class and store them 
together; such classes are nested classes. The containing class is the top-level class. There 
are four types of nested classes: 


e static member classes: A static member class has access to all static methods of the 
top-level class. 


e Nonstatic member classes, also known as inner classes: This type of class 
requires an instance; it has access to all data and methods of the top-level class. 


e Local classes: These are local to a block of code. 
e Anonymous classes: These are local classes that have no identifier. 


The most common reason to nest a class inside another is because the inner class is used only 
by the top-level class; in other words, it is a “helper class” to the top-level class. Being able to 
package the classes together makes their connection easier to understand and their code 
easier to maintain. 


For example, consider a RealEstateListing class used by a real estate company to 
describe houses that are available for sale. The class might contain separate fields for a 
listing number, the price, the street address, and the house’s living area. As an alternative, 
you might decide that although the listing number and price “go with” the real estate 
listing, the street address and living area really “go with” the house. So you might create 
an inner class like the one in Figure 4-45. 
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public class RealEstateListing 

{ 
private int listingNumber; 
private double price; 

228 private HouseData houseData; 

public RealEstateListingCint num, double price, String address, 
int sqFt) 





{ 
listingNumber = num; 
this.price = price; 
houseData = new HouseData(address, sqFt); 
} 
public void display() 
{ 


System.out.printInC"Listing number #" + 1istingNumber + 


Selling for $" + price); 
System.out.printInC"Address: " + houseData.streetAddress) ; 
System.out.printIln(houseData.squareFeet + " square feet"); 

} 

private class HouseData 

{ 
private String streetAddress; 
private int squareFeet; 
public HouseData(String address, int sqFt) 

{ 
streetAddress = address; 
squareFeet = sqFt; 





Figure 4-45 The RealEstateListing class 


Notice that the inner HouseData class in Figure 4-45 is a private class. You don’t have to 
make an inner class private, but doing so keeps its members hidden from outside classes. If 
you wanted a class’s members to be accessible, you would not make it an inner class. An inner 
class can access its top-level class’s fields and methods, even if they are private, and an outer 
class can access its inner class’s members. 


You usually will not want to create inner classes. For example, if you made the HouseData 
class a regular class (as opposed to an inner class) and stored it in its own file, you could 
use it with composition in other classes—perhaps a MortgageLoan class or an Appraisal 
class. As it stands, it is usable only in the class in which it now resides. You probably will 
not create nested classes frequently, but you will see them implemented in some built-in 
Java classes. 
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1. Exposition describes the relationship between classes when an object of one 229 
class is a data field within another class. 








2. When you use an object as a data member of another object, you must remember 
to supply values for the contained object if it has no default constructor. 


3. A nested class resides within another class. 
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Don't Do It 


e Don't try to use a variable that is out of scope. 


e Don’t assume that a constant is still a constant when passed to a method’s parameter. 
If you want a parameter to be constant within a method, you must use final in the 
parameter list. 


e Don't try to overload methods by giving them different return types. If their identifiers 
and parameter lists are the same, then two methods are ambiguous no matter what their 
return types are. 


e Don't think that default constructor means only the automatically supplied version. 
A constructor with no parameters is a default constructor, whether it is the one that is 
automatically supplied or one you write. 


e Don't forget to write a default constructor for a class that has other constructors if you 
want to be able to instantiate objects without using arguments. 


Key Terms 


A block is the code between a pair of curly braces. 
An outside block, or outer block, contains another block. 
An inside block, or inner block, is contained within another block. 


Nested describes the state of an inner block. 
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Comes into scope describes what happens to a variable when it becomes usable. 


Goes out of scope describes what happens to a variable when it ceases to exist at the end of 
the block in which it is declared. 


To redeclare a variable is to attempt to declare it twice—an illegal action. 
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A variable overrides another with the same name when it takes precedence over the other 
variable. 


Shadowing is the action that occurs when a local variable hides a variable with the same name 
that is further away in scope. 


Closer in scope describes the status of a local variable over others that it shadows. 


Overloading involves using one term to indicate diverse meanings, or writing multiple 
methods with the same name but with different arguments. 


An ambiguous situation is one in which the compiler cannot determine which method to use. 
A reference is an object’s memory address. 


The this reference is a reference to an object that is passed to any object’s nonstatic 
class method. 


Class methods are static methods that do not have a this reference (because they have no 
object associated with them). 


Class variables are static variables that are shared by every instantiation of a class. 
NaN is an acronym for Not a Number. 

A package is a library of classes. 

A library of classes is a folder that provides a convenient grouping for classes. 
The java. lang package is implicitly imported into every Java program. 


The fundamental classes are basic classes contained in the java. lang package that are 
automatically imported into every program you write. 


The optional classes reside in packages that must be explicitly imported into your programs. 









A wildcard symbol is an asterisk—a symbol used to indicate that it can be replaced by any set 
of characters. In a Java import statement, you use a wildcard symbol to represent all the 
classes in a package. 


Composition describes the relationship between classes when an object of one class is a data 
field within another class. 


A has-a relationship is a relationship based on composition. 
Nested classes are classes contained in other classes. 
The top-level class is the containing class in nested classes. 
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Chapter Summary iii 


A static member class is a type of nested class that has access to all static methods of its 
top-level class. 


Nonstatic member classes, also known as inner classes, are nested classes that require an 
instance. 


Local classes are a type of nested class that are local to a block of code. 231 








Anonymous classes are nested, local classes that have no identifier. 


Chapter Summary 


e A variable’s scope is the portion of a program within which you can reference that 
variable. A block is the code between a pair of curly braces. Within a method, you can 
declare a variable with the same name multiple times, as long as each declaration is in its 
own nonoverlapping block. If you declare a variable within a class and use the same 
variable name within a method of the class, the variable used inside the method takes 
precedence over (or overrides, or masks) the first variable. 


e Overloading involves writing multiple methods with the same name but different 
parameter lists. Methods that have identical parameter lists but different return types are 
not overloaded; they are illegal. 


e When you overload methods, you risk creating an ambiguous situation—one in which the 
compiler cannot determine which method to use. 


e When you write your own constructors, they can receive parameters. Such parameters 
are often used to initialize data fields for an object. After you write a constructor for a 
class, you no longer receive the automatically provided default constructor. If a class’s 
only constructor requires an argument, you must provide an argument for every object 
of the class that you create. You can overload constructors just as you can other 
methods. 


e Within nonstatic methods, data fields for the correct object are accessed because a this 
reference is implicitly passed to nonstatic methods. Static methods do not have a this 
reference because they have no object associated with them; static methods are also called 
class methods. 













e Static class fields and methods are shared by every instantiation of a class. When a field in 
a class is final, it cannot change after it is assigned its initial value. 


e Java contains hundreds of prewritten classes that are stored in packages, which are folders 
that provide convenient groupings for classes. The package that is implicitly imported into 
every Java program is named java. lang. The classes it contains are the fundamental 
classes, as opposed to the optional classes, which must be explicitly named. The class 
java. lang.Math contains constants and methods that can be used to perform common 
mathematical functions. The GregorianCalendar class allows you to define and 
manipulate dates and time. 
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Composition describes the relationship between classes when an object of one class is a data 
field within another class. You can create nested classes that are stored in the same file. 
The most common reason to nest a class inside another is because the inner class is used only 
by the outer or top-level class; in other words, it is a “helper class” to the top-level class. 


Review Questions 


The code between a pair of curly braces in a method is a 


a. function c. brick 
b. block d. sector 


When a block exists within another block, the blocks are 


a. structured c. sheltered 
b. nested d. illegal 


The portion of a program within which you can reference a variable is the 
variable’s 


a. range c. domain 
b. space d. scope 


You can declare variables with the same name multiple times 
within a statement 

within a block 

within a method 


ao F PS 


You never can declare multiple variables with the same name. 


If you declare a variable as an instance variable within a class, and you declare and 
use the same variable name within a method of the class, then within the 
method, 


a. the variable used inside the method takes precedence 

b. the class instance variable takes precedence 

c. the two variables refer to a single memory address 

d. an error will occur 

A method variable _______ a class variable with the same name. 
a. acquiesces to c. overrides 


b. destroys d. alters 
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7. Nonambiguous, overloaded methods must have the same 


a. name c. parameter names 
b. number of parameters d. types of parameters 

8. Ifa method is written to receive a double parameter, and you pass an integer to the 233 
method, then the method will 








a. work correctly; the integer will be promoted to a double 
b. work correctly; the integer will remain an integer 
c. execute, but any output will be incorrect 
d. not work; an error message will be issued 
9. Acconstructor __________ parameters. 
a. can receive c. must receive 
b. cannot receive d. can receive a maximum of 10 
10. A constructor __________ overloaded. 
a. can be c. must be 
b. cannot be d. is always automatically 


11. Usually, you want each instantiation of a class to have its own copy 


of 
a. the data fields c. both of the above 
b. the class methods d. none of the above 


12. If you create a class that contains one method and instantiate two objects, you 
usually store _________ for use with the objects. 

one copy of the method 

two copies of the method 

two different methods containing two different this references 
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data only (the methods are not stored) 








13. The this reference 
a. can be used implicitly c. must not be used implicitly 
b. must be used implicitly d. must not be used 

14. Methods that you reference with individual objects are 


a. private c. static 


b. public d. nonstatic 
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15. Variables that are shared by every instantiation of a class are 


a. class variables c. public variables 
b. private variables d. illegal 
234 16. The keyword final used with a variable declaration indicates 





the end of the program 
a static field 
a symbolic constant 


ao Ff 


that no more variables will be declared in the program 


17. Java classes are stored in a folder or 


a. packet c. bundle 
b. package d. gaggle 


18. Which of the following statements determines the square root of a number and 
assigns it to the variable s? 


as sqrt(Cnumber) ; c. number sqrt(s); 


Math. sqrt (number) ; d. number = Math.sqrt(s); 


Ss 


19. A GregorianCalendar object can be created with one of seven constructors. This 
means that the constructors 


a. override each other c. are overloaded 
b. are ambiguous d. all of the above 


20. The GregorianCalendar class get() method always returns a(n) 


a. day of the week c. integer 
b. date d. GregorianCalendar object 
Exercises 












(=) Programming Exercises 


1. Create a class named FormLetterWriter that includes two overloaded methods 
named displaySalutation(). The first method takes one String parameter that 
represents a customer’s last name, and it displays the salutation “Dear Mr. or Ms.” 
followed by the last name. The second method accepts two String parameters that 
represent a first and last name, and it displays the greeting “Dear” followed by the first 
name, a space, and the last name. After each salutation, display the rest of a short 
business letter: “Thank you for your recent order.” Write a main() method that tests 
each overloaded method. Save the file as FormLetterWriter.java. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
overall learning experi earning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





2. Create a class named Billing that includes three overloaded computeBil1Q 
methods for a photo book store. 


e When computeBil1() receives a single parameter, it represents the price of one 
photo book ordered. Add 8% tax, and return the total due. 


e When computeBil1() receives two parameters, they represent the price of a 235 
photo book and the quantity ordered. Multiply the two values, add 8% tax, and 
return the total due. 








e When computeBil1( receives three parameters, they represent the price of a photo 
book, the quantity ordered, and a coupon value. Multiply the quantity and price, 
reduce the result by the coupon value, and then add 8% tax and return the total due. 


Write a mainQ method that tests all three overloaded methods. Save the application 
as Billing.java. 


3. a. Create a BirdSighting class for the Birmingham Birdwatcher’s Club that includes 
data fields for a bird species sighted, the number seen, and the day of the year. For 
example, April 1 is the 91st day of the year, assuming it is not a leap year. The class 
also includes methods to get each field. In addition, create a default constructor that 
automatically sets the species to “robin” and the number and day to 1. Save the file as 
BirdSighting.java. Create an application named TestBi rdSighting that demonstrates 
that each method works correctly. Save the file as TestBirdSighting.java. 


b. Create an additional overloaded constructor for the BirdSighting class you 
created in Exercise 3a. This constructor receives parameters for each of the 
data fields and assigns them appropriately. Add any needed statements to the 
TestBirdSighting application to ensure that the overloaded constructor works 
correctly, save it, and then test it. 


c. Create a class with the same functionality as the BirdSighting class, but create 
the default constructor to call the three-parameter constructor. Save the class as 
BirdSighting2.java. Create an application to test the new version of the class, 
and name it TestBirdSighting2.java. 


4, a. Create a class named BloodData that includes fields that hold a blood type (the 
four blood types are O, A, B, and AB) and an Rh factor (the factors are + and —). 
Create a default constructor that sets the fields to “O” and “+”, and an overloaded 
constructor that requires values for both fields. Include get and set methods for 
each field. Save this file as BloodData.java. Create an application named 
TestBloodData that demonstrates that each method works correctly. Save the 
application as TestBloodData.java. 















b. Create a class named Patient that includes an ID number, age, and BloodData. 
Provide a default constructor that sets the ID number to “0”, the age to 0, and the 
BloodData to “O” and “+”. Create an overloaded constructor that provides 
values for each field. Also provide get methods for each field. Save the file as 
Patient.java. Create an application named TestPatient that demonstrates that 
each method works correctly, and save it as TestPatient.java. 
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5. a. Create a class for the Tip Top Bakery named Bread with data fields for bread 
type (such as “rye”) and calories per slice. Include a constructor that takes 
parameters for each field, and include get methods that return the values of 
the fields. Also include a public final static String named MOTTO and 
initialize it to The staff of life. Write an application named TestBread to 

236 instantiate three Bread objects with different values, and then display all the 

data, including the motto, for each object. Save both the Bread.java and 
TestBread.java files. 





b. Create a class named SandwichFilling. Include a field for the filling type (such as 
“ege salad”) and another for the calories in a serving. Include a constructor that 
takes parameters for each field, and include get methods that return the values of 
the fields. Write an application named TestSandwichFilling to instantiate three 
SandwichFilling objects with different values, and then display all the data for 
each object. Save both the SandwichFilling.java and TestSandwichFilling.java 
files. 


c. Create a class named Sandwich. Include a Bread field and a SandwichFilling 
field. Include a constructor that takes parameters for each field needed in the two 
objects and assigns them to each object’s constructor. Write an application 
named TestSandwich to instantiate three Sandwich objects with different values, 
and then display all the data for each object, including the total calories in a 
Sandwich, assuming that each Sandwich is made using two slices of Bread. Save 
both the Sandwich.java and TestSandwich.java files. 


6. a. Create a class named Circle with fields named radius, diameter, and area. 
Include a constructor that sets the radius to 1 and calculates the other two values. 
Also include methods named setRadius (and getRadius(). The setRadius() 
method not only sets the radius but also calculates the other two values. (The 
diameter of a circle is twice the radius, and the area of a circle is pi multiplied by 
the square of the radius. Use the Math class PI constant for this calculation.) Save 
the class as Circle.java. 


b. Create a class named TestCircle whose main() method declares several 
Circle objects. Using the setRadius() method, assign one Circle a small 
radius value, and assign another a larger radius value. Do not assign a value to 
the radius of the third circle; instead, retain the value assigned at construction. 
Display all the values for all the Circle objects. Save the application as 
TestCircle.java. 









7. Write a Java application that uses the Math class to determine the answers for each of 
the following: 


a. The square root of 37 
b. The sine and cosine of 300 


c. The value of the floor, ceiling, and round of 22.8 
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d. The larger and the smaller of the character “D” and the integer 71 


e. A random number between 0 and 20 (Hint: The random() method returns a 
value between 0 and 1; you want a number that is 20 times larger.) 


Save the application as MathTest.java. 
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8. Write an application that uses methods in the GregorianCalendar class to 
calculate how many days are left until the first day of next month. Save the file as 
NextMonth.java. 


9. Write an application that uses methods in the GregorianCalendar class to calculate 
the number of days from today until the end of the current year. Save the file as 
YearEnd.java. 


10. a. Create a CertificateOfDeposit class. The class contains data fields that hold a 
certificate number, account holder’s last name, balance, issue date, and maturity 
date, using GregorianCalendar objects for each date. Provide get and set 
methods for each field. Also provide a constructor that requires parameters 
used to set the first four fields, and sets the maturity date to exactly one year 
after the issue date. Save the class as CertificateOfDeposit.java. 


b. Create an interactive application that prompts the user for data for two 
CertificateOfDeposit objects. Prompt the user for certificate number, name, 
balance, and issue date for each CertificateOfDeposit, and then instantiate 
the objects. Display all the values, including the maturity dates. Save the 
application as TestCertificateOfDeposit.java. 


1l. Create a class named State that holds the following fields: a String for the 
name of the state, an integer for the population, and two City objects that hold 
data about the capital city and the most populous city. The State constructor 
requires six parameters that represent the names and populations of the state, 
its capital, and its most populous city. Provide get methods for each field. 
Create the City class to be a nonstatic, private inner class within the State 
class; the City class contains a city’s name and population. Create a class to 
assign values to and display values from two State objects. Save the files as 
State.java and TestState.java. 










%& Debugging Exercises 


1. Each of the following files in the Chapter04 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and fix the 
program. After you correct the errors, save each file using the same filename 
preceded with Fix. For example, save DebugFourl.java as FixDebugFour1 java. 

DebugFourl java 

DebugFour2.java 

DebugFour3.java and DebugBox.java 

) 


ao fF 


DebugFour4.java 
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When you change a filename, remember to change every instance of the class name within the file so that it 
matches the new filename. In Java, the filename and class name must always match. 


Game Zone 


Dice are used in many games. One die can be thrown to randomly show a value 
from 1 through 6. Design a Die class that can hold an integer data field for a value 
(from 1 to 6). Include a constructor that randomly assigns a value to a die object. 
Appendix D contains information on generating random numbers. To fully under- 
stand the process, you must learn more about Java classes and methods. However, 
for now, you can copy the following statement to generate a random number 
between 1 and 6 and assign it to a variable. Using this statement assumes you have 
assigned appropriate values to the static constants. 


randomValue = (Cint)(Math.random() * 100) % HIGHEST_DIE_VALUE + 
LOWEST_DIE_VALUE) ; 


Also include a method in the class to return a die’s value. Save the class as Die.java. 


Write an application that randomly “throws” two dice and displays their values. 
After you read the chapter Making Decisions, you will be able to have the game 
determine the higher die. For now, just observe how the values change as you 
execute the program multiple times. Save the application as TwoDice.java. 


Using the Die class, write an application that randomly “throws” five dice for the 
computer and five dice for the player. Display the values and then, by observing 
the results, decide who wins based on the following hierarchy of Die values. 

(The computer will not decide the winner; the player will determine the winner 
based on observation.) Any higher combination beats a lower one; for example, five 
of a kind beats four of a kind. 


e Five of a kind 

e Four of a kind 

e Three of a kind 

e A pair 

After you learn about decision making in the next chapter, you will be able 
to make the program determine whether you or the computer had the better 
roll, and after you read the chapter Arrays, you will be able to make the 
determination more efficient. For now, just observe how the values change 


as you execute the program multiple times. Save the application as 
FiveDice.java. 
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Case Problems 


These projects build on the ones you created in Chapter 3, so they have the same 
filenames. If you want to retain both versions of the files, save them in different folders. 239 








1. a. Carly’s Catering provides meals for parties and special events. In Chapter 3, you 
created an Event class for the company. The Event class contains two public 
final static fields that hold the price per guest ($35) and the cutoff value for 
a large event (50 guests), and three private fields that hold an event number, 
number of guests for the event, and the price. It also contains two public set 
methods and three public get methods. 


Now, modify the Event class to contain two overloaded constructors. 


e One constructor accepts an event number and number of guests as parameters. 
Pass these values to the setEventNumber() and setGuests() methods, 
respectively. The setGuests( method will automatically calculate the event 
price. 


e The other constructor is a default constructor that passes “A000” and 0 to the 
two-parameter constructor. 


Save the file as Event.java. 


b. In Chapter 3, you also created an EventDemo class to demonstrate using 
two Event objects. Now, modify that class to instantiate two Event objects, 
and include the following new methods in the class: 


e Instantiate one object to retain the constructor default values. 


e Accept user data for the event number and guests fields, and use this data set to 
instantiate the second object. Display all the details for both objects. 


Save the file as EventDemo.java. 


2. a. Sammy’s Seashore Supplies rents beach equipment such as kayaks, canoes, 
beach chairs, and umbrellas to tourists. In Chapter 3, you created a Rental 
class for the company. The Rental class contains two public final static 
fields that hold the number of minutes in an hour and the hourly rental rate 
($40), and four private fields that hold a contract number, number of hours 
for the rental, number of minutes over an hour, and the price. It also contains 
two public set methods and four public get methods. 













Now, modify the Rental class to contain two overloaded constructors. 


e One constructor accepts a contract number and number of minutes as 
parameters. Pass these values to the setContractNumber() and 
setHoursAndMinutes() methods, respectively. The setHoursAndMinutes () 
method will automatically calculate the hours, extra minutes, and price. 
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e The other constructor is a default constructor that passes “A000” and 0 to the 
two-parameter constructor. 


Save the file as Rental.java. 


b. In Chapter 3, you also created a RentalDemo class to demonstrate a Rental 
240 object. Now, modify that class to instantiate two Rental objects. 





e Instantiate one object to retain the constructor default values. 


e Accept user data for the contract number and minutes fields and use this data 
set to instantiate the second object. Display all the details for both objects. 


Save the file as RentalDemo.java. 
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Making Decisions 


In this chapter, you will: 


Plan decision-making logic 


(©) 


Make decisions with the if and 7f...e]se structures 


(©) 


Use multiple statements in if and 71f...el1se clauses 


(©) 


Nest 1f and 7f...else statements 
UKXeW ANN DI] a(e ©) name) \-1a-1k0) 6s 
Make accurate and efficient decisions 


(OR ORTO) 


Use the switch statement 


(©) 


Use the conditional and NOT operators 


(©) 


Assess operator precedence 


(©) 


Add decisions and constructors to instance methods 


(©) 





Unless noted otherwise, all images are © 2014 Cengage Learning 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 5 Making Decisions 


Planning Decision-Making Logic 


When computer programmers write programs, they rarely just sit down at a keyboard and 

begin typing. Programmers must plan the complex portions of programs using paper and 

pencil. Programmers often use pseudocode, a tool that helps them plan a program’s logic 
242 by writing plain English statements. Using pseudocode requires that you write down the 
steps needed to accomplish a given task. You write pseudocode in everyday language, not 
the syntax used in a programming language. In fact, a task you write in pseudocode does 
not have to be computer-related. If you have ever written a list of directions to your 
house—for example, (1) go west on Algonquin Road, (2) turn left on Roselle Road, 
(3) enter expressway heading east, and so on—you have written pseudocode. A flowchart 
is similar to pseudocode, but you write the steps in diagram form, as a series of shapes 
connected by arrows. 








Some programmers use a variety of shapes to represent 
different tasks in their flowcharts, but you can draw simple 
flowcharts that express very complex situations using just 
rectangles and diamonds. You use a rectangle to represent 
any unconditional step and a diamond to represent any 
decision. For example, Figure 5-1 shows a flowchart 
describing driving directions to a friend’s house. The logic 
in Figure 5-1 is an example of a logical structure called 

a sequence structure—one step follows another 
unconditionally. A sequence structure might contain 

any number of steps, but when one task follows another 
with no chance to branch away or skip a step, you are 
using a sequence. 


Go west on 
Algonquin Road 
















Turn left on 
Roselle Road 








Enter expressway 
heading east 





Exit south at 
Arlington 
Heights Road 


Sometimes, logical steps do not follow in an unconditional 
sequence—some tasks might or might not occur based on 
decisions you make. To represent a decision, flowchart 
creators use a diamond shape to hold a question, and they 
draw paths to alternative courses of action emerging from 
the sides of the diamonds. Figure 5-2 shows a flowchart 
describing directions in which the execution of some 
steps depends on decisions. 


Proceed to 688 
Arlington 
Heights Road 








Figure 5-1 Flowchart of 
a series of sequential steps 
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Planning Decision-Making Logic D0 


Figure 5-2 includes a decision 
structure—one that involves 
choosing between alternative Gowest on 
courses of action based on Algonquin Road 
some value within a program. 
For example, the program that 
produces your paycheck can 
make decisions about the proper 
amount to withhold for taxes, 
the program that guides a missile 
can alter its course, and a 
program that monitors your 
blood pressure during surgery 
can determine when to sound ; 

: _ . Enter expressway Continue on 
an alarm. Making decisions is heading east Roselle to Coif 
what makes computer Road 
programs seem “smart.” 
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Turn left on 
Roselle Road 






Is the expressway 
backed up? 








: Exit south at 
When reduced to their most plein 


basic form, all computer Heights Road Turn left on 
decisions are yes-or-no Colt 
decisions. That is, the answer 
to every computer question cunrECoR 
is yes or no (or true or false, Arlington 
or on or off). This is because Heights Road 
computer circuitry consists of 
millions of tiny switches that 
are either on or off, and the 
result of every decision sets Proceed to 688 
one of these switches in le 

: eights Road 
memory. As you learned in 
Chapter 2, the values true 
and false are Boolean values; 
every computer decision Figure 5-2 Flowchart including a decision 
results in a Boolean value. 
Thus, internally, a program 
never asks, for example, “What number did the user enter?” Instead, the decisions might 
be “Did the user enter a 1?” “If not, did the user enter a 2?” “If not, did the user enter a 3?” 





the three most basic operations of which were (and still are) AND, OR, and NOT. All computer logic is based 


Sir George Boole lived from 1815 to 1864. He developed a type of linguistic algebra, based on Os and Is, 
Y on his discoveries. 
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244 1. Pseudocode and flowcharts are both tools that are used to check the syntax 
of computer programs. 


In a sequence structure, one step follows another unconditionally. 


In a decision structure, alternative courses of action are chosen based on a 
Boolean value. 
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The if and if...else Structures 


In Java, the simplest statement you can use to make a decision is the if statement. For 
example, suppose you have declared an integer variable named quizScore, and you want 
to display a message when the value of quizScore is 10. The if statement in Figure 5-3 
makes the decision whether to produce output. Note that the double equal sign ( == ) is 
used to determine equality; it is Java’s equivalency operator. 


ifCquizScore == 10) 
System.out.printInC"The score is perfect"); 


quizScore 
== 10? 


output "The 
score is perfect" 


Figure 5-3. A Java if statement 





In the example in Figure 5-3, if quizScore holds the value 10, the Boolean value of the 
expression quizScore == 10 is true, and the subsequent output statement executes. If the 
value of the expression quizScore == 10 is false, the output statement does not execute. 
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As the flowchart segment shows, whether the tested expression is true or false, the 
program continues and executes any statements that follow the if statement. 


An if statement always includes parentheses. Within the parentheses, you can place any 
Boolean expression. Most often you use a comparison that includes one of the relational 
operators you learned about in Chapter 2 ( ==, <, >, <=, >=, or != ). However, you can use any 
expression that evaluates as true or false, such as a simple boolean variable or a call to a 
method that returns a boolean value. 
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Pitfall: Misplacing a Semicolon in an if Statement 


In a Java if statement, the Boolean expression, such as (quizScore == 10), must appear 
within parentheses. In Figure 5-3, there is no semicolon at the end of the first line of the 
if statement following the parentheses because the statement does not end there. 

The statement ends after the printIn© call, so that is where you type the semicolon. 
You could type the entire if statement on one line and it would execute correctly; 
however, the two-line format for the if statement is more conventional and easier to 
read, so you usually type if and the Boolean expression on one line, press Enter, and 
then indent a few spaces before coding the action that occurs if the Boolean expression 
evaluates as true. Be careful—if you use the two-line format and type a semicolon at 
the end of the first line, as in the example shown in Figure 5-4, the results might not be 
what you intended. 





Don't Do It 
This semicolon was 


unintentional. 






if(quizScore == 10); 
System.out.printInC"The score is perfect"); 


This indentation 
has no effect. 


This statement executes 





no matter what the 
value of quizScore is. 





quizScore 
== 10? 





output "The score 
is perfect" 


Figure 5-4 Logic that executes when an extra semicolon is inserted in an if statement 
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When the Boolean expression in Figure 5-4 is true, an empty statement that contains only 
a semicolon executes. Whether the tested expression evaluates as true or false, the decision is 
over immediately, and execution continues with the next independent statement that displays a 
message. In this case, because of the incorrect semicolon, the if statement accomplishes nothing. 
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Pitfall: Using the Assignment Operator Instead 
of the Equivalency Operator 


Another common programming error occurs when a programmer uses a single equal sign 
rather than the double equal sign when attempting to determine equivalency. The expression 
quizScore = 10 does not compare quizScore to 10; instead, it attempts to assign the 
value 10 to quizScore. When the expression quizScore = 10 is used in the if statement, 
the assignment is illegal because only Boolean expressions are allowed. The confusion arises 
in part because the single equal sign is used within Boolean expressions in if statements 
in several older programming languages, such as COBOL, Pascal, and BASIC. Adding to 
the confusion, Java programmers use the word equals when speaking of equivalencies. 
For example, you might say, “If quizScore equals 10...”. 


assign true to x. However, such a statement would be useless because the value of such an expression 


The expression if (x = true) will compile only if x is abool ean variable, because it would be legal to 
Y could never be false. 


An alternative to using a Boolean expression in an if statement, such as quizScore == 10, is 
to store the Boolean expression’s value in a Boolean variable. For example, if isPerfectScore 
is a Boolean variable, then the following statement compares quizScore to 10 and stores true 
or false in isPerfectScore: 


isPerfectScore = (quizScore == 10); 


Then, you can write the if statement as: 


if(CisPerfectScore) 
System.out.printIn("The score is perfect"); 


This adds an extra step to the program, but makes the if statement more similar to an 
English-language statement. 


comparison operator, as in 10 == quizScore. This practice is a holdover from other programming 
languages, such as C++, in which an accidental assignment might be made when the programmer types the 
assignment operator (a single equal sign) instead of the comparison operator (the double equal sign). In Java, 
the compiler does not allow you to make a mistaken assignment in a Boolean expression. 


Q When comparing a variable to a constant, some programmers prefer to place the constant to the left of the 


Pitfall: Attempting to Compare Objects Using 
the Relational Operators 


You can use the standard relational operators ( ==, <, >, <=, >=, and != ) to compare the values 
of primitive data types such as int and double. However, you cannot use <, >, <=, or >= to 
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compare objects; a program containing such comparisons does not compile. You can use 
the equals and not equals comparisons (== and !=) with objects, but when you use them, 
you compare the objects’ memory addresses instead of their values. Recall that every 
object name is a reference; the equivalency operators compare objects’ references. In other 
words, == only yields true for two objects when they refer to the same object in memory, 
not when they are different objects with the same value. To compare the values of objects, 247 
you should write specialized methods. Remember, Strings are objects, so do not use == to 
compare Strings. You will learn more about this in the chapter Characters, Strings, and 

the StringBuilder. 








Although object names are references, their field names are not references if they represent 
simple, primitive data types. You can compare the values between objects’ fields by using 
public accessor methods. For example, suppose you have created a class named Student with 
a double grade point average field and a nonstatic public method named getGpa(). After 
instantiating two objects named student1 and student2, you can write a statement such 

as the following: 


if(studentl.getGpaQ) > student2.getGpaQ) 
System.out.printIn("The first student has a higher gpa"); 


The values represented by student1.getGpa() and student2.getGpa() are both doubles, 
so they can be compared using any of the relational operators. 


The 7 f...e1se Structure 
Consider the following statement: 


if(quizScore == 10) 
System.out.printIn("The score is perfect"); 


Such a statement is sometimes called a single-alternative if because the program only 
performs an action, or not, based on one alternative; in this example, a statement is displayed 
when quizScore is 10. Often, you require two options for the course of action following a 
decision. A dual-alternative if is the decision structure you use when you need to take one or 
the other of two possible courses of action. For example, you would use a dual-alternative 
if structure if you wanted to display one message when the value of quizScore is 10 and 

a different message when it is not. In Java, the if..e1se statement provides the mechanism 
to perform one action when a Boolean expression evaluates as true and to perform a 
different action when a Boolean expression evaluates as false. 


The code in Figure 5-5 displays one of two messages. In this example, when the value of 
quizScore is 10, the if clause of the statement executes, displaying the message “The score is 
perfect”. When quizScore is any other value, the else clause of the statement executes and 
the program displays the message “No, it’s not”. You can code an if without an else, but it is 
illegal to code an else without an if that precedes it. 
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ifCquizScore == 10) 

System.out.printInC"The score is perfect"); 
else 

System.out.printInC"No, it's not"); 
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quizScore 
== 10? 








output "No, 
it's not" 


Figure 5-5 An7f...else structure 


output "The score 
is perfect" 








The indentation shown in the example code in Figure 5-5 is not required but is standard 
usage. You vertically align the keyword if with the keyword else, and then indent the 
action statements that depend on the evaluation. 


When you execute an if...e1se statement, only one of the resulting actions takes place 
depending on the evaluation of the Boolean expression. Each statement, the one following the 
if and the one following the else, is a complete statement, so each ends with a semicolon. 


ee 7” 
= Watch the video Making Decisions. 


The if and if...else Structures 


1. Ina Java if statement, the keyword if is followed by a Boolean expression 
within parentheses. 


In a Java if statement, a semicolon follows the Boolean expression. 


When determining equivalency in Java, you use a double equal sign. 
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aN You Do It 


Using an if...e1se Statement 249 








In this section, you start writing a program for Sacks Fifth Avenue, a nonprofit thrift 
shop. The program determines which volunteer to assign to price a donated item. To 
begin, you prompt the user to answer a question about whether a donation is clothing 
or some other type, and then the program displays the name of the volunteer who 
handles such donations. Clothing donations are handled by Regina, and other dona- 
tions are handled by Marco. 


1. Open a new text file, and then enter the first lines of code to create a class 
named AssignVolunteer. You import the Scanner class so that you can use 
keyboard input. The class contains a mainQ@ method that performs all the 
work of the class: 


import java.util .Scanner; 
public class AssignVolunteer 


{ 
public static void main(StringL[] args) 


{ 


2. On new lines, declare the variables and constants this application uses. The 
user will be prompted to enter one of the values stored in the two constants. 
That value will then be assigned to the integer donationType and compared to 
the CLOTHING_CODE constant. Then, based on the results of that comparison, 
the program will assign the value of one of the PRICER constants to the String 
variable volunteer. 


int donationType; 

String volunteer; 

final int CLOTHING CODE = 1; 

final int OTHER_CODE = 2; 

final String CLOTHING PRICER = "Regina"; 
final String OTHER_PRICER = "Marco"; 


3. Define the input device, and then add the code that prompts the user to 
enter a 1 or 2 for the donation type. Accept the response, and assign it to 
donationType: 


Scanner input = new Scanner (System. in) ; 

System.out.printInC"What type of donation is this?"); 

System.out.printC"Enter " + CLOTHING_CODE +" for clothing, "+ 
OTHER_CODE + " for anything else... ""); 

donationType = input.nextInt(); 


(continues) 
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(continued) 


4. Use an if..else statement to choose the name of the volunteer to be assigned 
to the volunteer String, as follows: 


250 if (donat ionType == CLOTHING CODE) 


volunteer = CLOTHING PRICER; 
else 
volunteer = OTHER_PRICER; 





5. Display the chosen code and corresponding volunteer’s name: 


System.out.printInC"You entered " + donationType) ; 
System.out.printInC"The volunteer who will price this item is " + 
volunteer) ; 


6. Type the two closing curly braces to end the main® method and the 
AssignVolunteer Class. 


7. Save the program as AssignVolunteer.java, and then compile and run the 
program. Confirm that the program selects the correct volunteer when you 
choose 1 for a clothing donation or 2 for any other donation type. For example, 
Figure 5-6 shows a typical execution of the program when the user enters 1 
for a clothing donation. 


C:\Java>java AssignvUolunteer 
i is this? 
1 for clothing. 2 for anything else... 
You entered 1 











Figure 5-6 Typical execution of the AssignVolunteer application 


Using Multiple Statements in if and if..else Clauses 


Often, you want to take more than one action following the evaluation of a Boolean 
expression within an if statement. For example, you might want to display several separate 
lines of output or perform several mathematical calculations. To execute more than one 
statement that depends on the evaluation of a Boolean expression, you use a pair of curly 
braces to place the dependent statements within a block. For example, the program 
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segment shown in Figure 5-7 determines whether an employee has worked more than the 
value of a FULL_WEEK constant; if so, the program computes regular and overtime pay. 





ifChoursWorked > FULL_WEEK) 
{ 251 


regularPay = FULL_WEEK * rate; 
overtimePay = (hoursWorked —- FULL_WEEK) * OT_RATE * rate; 











The if structure 
ends here. 






hoursWorked > 
FULL_WEEK? 


regularPay = FULL_WEEK * rate 


overtimePay = (hoursWorked - 
FULL_WEEK) * OT_RATE * rate 





Figure 5-7 An if structure that determines pay 


When you place a block within an if statement, it is crucial to place the curly braces 
correctly. For example, in Figure 5-8, the curly braces have been omitted. Within the code 
segment in Figure 5-8, when hoursWorked > FULL_WEEK is true, regularPay is calculated 
and the if expression ends. The next statement that computes overtimePay executes 
every time the program runs, no matter what value is stored in hoursWorked. This last 
statement does not depend on the if statement; it is an independent, stand-alone statement. 
The indentation might be deceiving; it looks as though two statements depend on the 

if statement, but indentation does not cause statements following an if statement to 

be dependent. Rather, curly braces are required if multiple statements must be treated as 

a block. 


When you create a block, you do not have to place multiple statements within it. It is perfectly 
legal to place curly braces around a single statement. For clarity, some programmers always 
use curly braces to surround the actions in an if statement, even when there is only one 
statement in the block. 
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Don't Do It 
The if structure ends 
here. 








252 if(hoursWorked > FULL_WEEK) 
regularPay = FULL_WEEK * rate; 
overtimePay = (hoursWorked - FULL_WEEK) * OT_RATE * rate; 


This indentation is 


Don't Do It 
The overtime calculation 
is always performed no 


ignored by the 
compiler. 









matter what the value of 
hoursWorked is. 





hoursWorked > 
FULL_WEEK? 


regularPay = FULL_WEEK * rate 


overtimePay = (hoursWorked - 
FULL_WEEK) * OT_RATE * rate 





Figure 5-8 Erroneous overtime pay calculation with missing curly braces 


Because the curly braces are missing, regardless of whether hoursWorked is more than 
FULL_WEEK, the last statement in Figure 5-8 is a new stand-alone statement that is not part 
of the if, and so it always executes. If hoursWorked is 30, for example, and FULL_WEEK is 40, 
then the program calculates the value of overtimePay as a negative number (because 

30 minus 40 results in -10). Therefore, the output is incorrect. Correct blocking is crucial 
to achieving valid output. 


When you fail to block statements that should depend on an if, and you also use an else 
clause, the program will not compile. For example, consider the following code: 


ifChoursWorked > FULL_WEEK) Don't Do It 
regularPay = FULL_WEEK * rate; These statements 
overtimePay = (hoursWorked —- FULL_WEEK) * OT_RATE * rate; should be blocked. 





else 
regularPay = FULL_WEEK * rate; 


In this case, the if statement ends after the first regularPay calculation, and the second 
complete stand-alone statement performs the overtimePay calculation. The third statement 
in this code starts with else, which is illegal. An error message will indicate that the program 
contains “else without if”. 
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Just as you can block statements to depend on an if, you can also block statements to 
depend on an else. Figure 5-9 shows an application that contains an if structure with 
two dependent statements and an else with two dependent statements. The program 
executes the final printIn@ statement without regard to the hoursWorked variable’s 
value; it is not part of the if structure. Figure 5-10 shows the output from two executions 
of the program. In the first execution, the user entered 39 for the hoursWorked value and 253 
20.00 for rate; in the second execution, the user entered 42 for hoursWorked and 20.00 
for rate. 








import java.util.Scanner; 
public class Payrol] 
{ 
public static void main(String[] args) 
{ 
double rate; 
double hoursWorked; 
double regularPay; 
double overtimePay; 
final int FULL_WEEK = 40; 
final double OT_RATE = 1.5; 
Scanner keyboard = new Scanner(System.in); 
System.out.printC"How many hours did you work this week? "); 
hoursWorked = keyboard.nextDouble() ; 
System.out.printC"What is your regular pay rate? "); 
rate = keyboard.nextDoubleQ) ; 
ifChoursWorked > FULL_WEEK) 
{ 
regularPay = FULL_WEEK * rate; 
overtimePay = (hoursWorked - FULL_WEEK) * OT_RATE * rate; 
} 
else 
{ 
regularPay = hoursWorked * rate; 
overtimePay = 0.0; 
} 
System.out.printInC"Regular pay is " + 
regularPay + "\nOvertime pay is " + overtimePay) ; 





Figure 5-9 Payrol] application containing an if and else clause with blocks 
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in = 
Gal Command Prompt _:. 7 a 


C:\Java>java Payroll 

How many hours did you work this week? 3? 
What is your regular pay rate? 26.66 
Regular pay is 786.6 

Overtime pay is 6.6 





NIC :\Java>java Payroll 

How many hours did you work this week? 42 
What is your regular pay rate? 26.06 
Regular pay is 806.6 

Overtime pay is 60.6 


C:\NJava>_ 











Figure 5-10 Output of the Payrol1 application 


When you block statements, you must remember that any variable you declare within a block 
is local to that block. For example, the following code segment contains a variable named 
sum that is local to the block following the if. The last print1n© statement causes an 
error because the sum variable is not recognized: 


if(a == b) 


t ae. _ fs The sum variable is 
Ne SUM Sele Dis declared in this block... 
System.out.printin 

C"The two variables are equal"); 


} 


System.out.printIn("The sum is ..$0 it is not 


recognized here. 


+ sum); 


Using Multiple Statements in if and if...else Clauses 


1. To execute more than one statement that depends on the evaluation of a 
Boolean expression, you use a pair of curly braces to place the dependent 
statements within a block. 


2. Indentation can be used to cause statements following an if statement to 
depend on the evaluation of the Boolean expression. 


3. When you declare a variable within a block, it is local to that block. 
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KK 
*\. You Do It 
Using Multiple Statements in if and else Clauses 


In this section, you use a block of code to add multiple actions to an if..else 
statement. 


255 








1. Open the AssignVolunteer application from the previous “You Do It” section. 
Change the class name to AssignVolunteer2, and immediately save the file 
as AssignVolunteer2.java. 


2. Adda String to the variables. This String will be assigned a message that 
displays the donation type: 


String message; 


3. Inplace of the existing if..e1se statement in the program, insert the following 
statement that takes two blocked actions for each donation type. It assigns a 
volunteer and assigns a value to the message String. 


if (donationType == CLOTHING_CODE) 
{ 
volunteer = CLOTHING PRICER; 
message = "a clothing donation"; 
} 
else 
{ 
volunteer = OTHER_PRICER; 
message = "another donation type"; 


} 


4. Following the output statement that displays the donation type, add the 
following statement that displays the assigned message: 


System.out.printInC"This is " + message) ; 


(continues) 
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(continued) 
5. Save the file, and compile and execute the program. Figure 5-11 shows two 
executions. 
= 
f=9 Command Prompt o |e 






C:\Java>java AssignUolunteer2 
What type of donation is this? 
Enter 1 for clothing. 2 for anything else... 1 
You entered 1 
is is a clothing donation 
The volunteer who will price this item is Regina 


C:\Java>java AssignUolunteer2 

mWvhat type of donation is this? 

Enter 1 for clothing. 2 for anything else 
HYou entered 2 

MThis is another donation type 

athe volunteer who will price this item is 


C:\Java> 





Figure 5-11 Two executions of the AssignVolunteer2 program 


Nesting if and if..e1se Statements 


Within an if or an else clause, you can code as many dependent statements as you need, 
including other if and else structures. Statements in which an if structure is contained 

inside another if structure are commonly called nested if statements. Nested if statements 
are particularly useful when two conditions must be met before some action is taken. 


For example, suppose you want to pay a $50 bonus to a salesperson only if the salesperson 
sells at least three items that total at least $1,000 in value during a specified time. Figure 5-12 
shows the logic and the code to solve the problem. 


experience. Cel 
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itemsSold >= 
MIN_ITEMS? 
final int MIN_ITEMS = 3; 257 
final int MIN_VALUE 1000; 
final int SALES_BONUS = 50; 
int bonus = 0; 








totalValue >= 
MIN_VALUE? 






ifCitemsSold >= MIN_ITEMS) 
ifCtotalValue >= MIN_VALUE) 
bonus = SALES_BONUS; 






bonus = 
SALES_BONUS 





The Boolean expression in each 
if statement must be true for 


the bonus assignment to be 
made. 








Figure 5-12 Determining whether to assign a bonus using nested if statements 


Notice there are no semicolons in the if statement code shown in Figure 5-12 until after the 
bonus = SALES BONUS; statement. The expression itemsSold >= MIN_ITEMS is evaluated 
first. Only if this expression is true does the program evaluate the second Boolean expression, 
totalValue >= MIN_VALUE. If that expression is also true, the bonus assignment statement 
executes, and the if structure ends. 


When you use nested if statements, you must pay careful attention to placement of any 
else clauses. For example, suppose you want to distribute bonuses on a revised schedule. 
If the salesperson does not sell at least three items, you want to give a $10 bonus. If the 
salesperson sells at least three items whose combined value is less than $1,000, the bonus 
is $25. If the salesperson sells at least three items whose combined value is at least $1,000, 
the bonus is $50. Figure 5-13 shows the logic. 
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final 
final 
jitemsSold >= final 
MIN_ITEMS? final 
final 
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bonus = 
SMALL_BONUS 









totalValue >= true 


MIN_VALUE? 








bonus = 
LARGE_BONUS 


bonus = 
MEDIUM_BONUS 


else 


int MIN_ITEMS = 3; 

int MIN_VALUE = 1000; 
int LARGE_BONUS= 50; 
int MEDIUM_BONUS = 25; 
int SMALL_BONUS = 10; 


int bonus = 0; 


ifCitemsSold >= MIN_ITEMS) 
if(totalValue >= MIN_VALUE) 


bonus = LARGE_BONUS; 


else 


bonus = MEDIUM_BONUS; 


bonus = SMALL_BONUS; 


The last else goes 


with the first if. 








Figure 5-13 Determining one of three bonuses using nested if statements 


As Figure 5-13 shows, when one if statement follows another, the first else clause 
encountered is paired with the most recent if encountered. In this figure, the complete 


nested if..else structure fits entirely within the if portion of the outer if..else statement. 
No matter how many levels of i f..e1se statements are needed to produce a solution, the else 
statements are always associated with their ifs on a “first in-last out” basis. In Figure 5-13, 

the indentation of the lines of code helps to show which else statement is paired with which 
if statement. Remember, the compiler does not take indentation into account, but consistent 


indentation can help readers understand a program’s logic. 


Nesting if and if...else Statements 


1. Statements in which an if structure is contained inside another if structure 


commonly are called nested if statements. 


2. When one if statement follows another, the first else clause encountered is 


paired with the first if that occurred before it. 


3. Acomplete nested if...e1se structure always fits entirely within either the if 
portion or the else portion of its outer if..else statement. 
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v You Do It 
Using a Nested if Statement 259 
In this section, you add a nested if statement to the AssignVolunteer2 application. 
1. Rerun the AssignVolunteer2 program, and enter an invalid code, such as 3. 
The selected volunteer is Marco because the program tests only for an 
entered value of 1 or not 1. Modify the program to display the entered code, 
volunteer, and donation type message only when the entered value is 1 or 2, 
and to display the entered code and an error message otherwise. Rename the 
class AssignVolunteer3, and save the file as AssignVolunteer3.java. 
Figure 5-14 shows two typical executions of the program. 
[i = 
fay Command Prompt 
C:\Java>java AssignVolunteer3 
Enter 1 for clothing. 2 for anything else... 3 
mlhe volunteer who will price this item is invalid 
C:\Java>java AssignUolunteer3 
What type of donation is this? 
Enter 1 for clothing. 2 for anything else 
patli@m-Jiba-S 0-114 
This is another donation type 
The volunteer who will price this item is 
C:\Java> 
Figure 5-14 Two executions of the AssignVolunteer3 program 
Using Logical AND and OR Operators 
In Java, you can combine two Boolean tests into a single expression using the logical 
AND and OR operators. 
The AND Operator 
For an alternative to some nested if statements, you can use the logical AND operator 
between two Boolean expressions to determine whether both are true. In Java, the AND 
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operator is written as two ampersands ( && ). For example, the two statements shown 
in Figure 5-15 work exactly the same way. In each case, both the itemsSold variable must 
be at least the minimum number of items required for a bonus and the totalValue variable 
must be at least the minimum required value for the bonus to be set to SALES_BONUS. 


260 





jtemsSold > 
MIN_ITEMS? 


totalValue >= 
MIN_VALUE? 


bonus = 
SALES_BONUS 


ifCitemsSold > MIN_ITEMS) 
if(totalValue >= MIN_VALUE) 
bonus = SALES_BONUS; 


ifCitemsSold > MIN_ITEMS && totalValue >= MIN_VALUE) 
bonus = SALES_BONUS; 





Figure 5-15 Code for bonus-determining decision using nested ifs and using the && operator 


It is important to note that when you use the && operator, you must include a complete 
Boolean expression on each side. In other words, like many arithmetic operators, the && 
operator is a binary operator, meaning it requires an operand on each side. If you want to 
set a bonus to $400 when a saleAmount is both over $1,000 and under $5,000, the correct 
statement is: 


if(saleAmount > 1000 && saleAmount < 5000) 
bonus = 400; 


Even though the saleAmount variable is intended to be used in both parts of the AND 
expression, the following statement is incorrect and does not compile because there is not 
a complete expression on both sides of the binary && operator: 


Don't Do It 
This statement will not compile 
if(saleAmount > 1000 && < 5000) because it does not have a Boolean 
bonus = 400; expression on each side of the 
&& operator. 





For clarity, many programmers prefer to surround each Boolean expression that is part of a 
compound Boolean expression with its own set of parentheses, as in the following example: 
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Using Logical AND and OR Operators. 


ifCCsaleAmount > 1000) && (saleAmount < 5000)) 
bonus = 400; 


Use the extra parentheses if doing so makes the compound expression clearer to you. 


You are never required to use the && operator because using nested if statements always 
achieves the same result, but using the && operator often makes your code more concise, 261 
less error-prone, and easier to understand. 








The OR Operator 


When you want some action to occur even if only one of two conditions is true, you can 
use nested if statements, or you can use the logical OR operator, which is written as | |. 


For example, if you want to give a discount to any customer who satisfies at least one of two 
conditions—buying a minimum number of items or buying any number of items that total 
a minimum value—you can write the code using either of the ways shown in Figure 5-16. 


The two vertical lines used in the OR operator are sometimes called “pipes.” The pipe appears on the same 
key as the backslash on your keyboard. 


ifCitemsBought >= MIN_ITEMS) 
discountRate = DISCOUNT; 
else 
ifCitemsValue >= MIN_VALUE) 
discountRate = DISCOUNT; 


ifCitemsBought >= MIN_ITEMS || itemsValue >= MIN_VALUE) 
discountRate = DISCOUNT; 


TtemsBought >= 


MIN_ITEMS? 


discountRate = 
itemsValue >= DISCOUNT 
MIN_VALUE? 


discountRate = 
DISCOUNT 





Figure 5-16 Determining customer discount when customer needs to meet only one of two criteria 


As with the && operator, you are never required to use the || operator because using nested 
if statements always achieves the same result. However, using the | | operator often makes 
your code more concise, less error-prone, and easier to understand. 
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Short-Circuit Evaluation 


The expressions on each side of the && and || operators are evaluated only as far as 
necessary to determine whether the entire expression is true or false. This feature is called 
short-circuit evaluation. With the && operator, both Boolean expression operands must 
262 be true before the action in the result statement can occur. (The same is true for nested 3 fs, 
as you can see in Figure 5-15.) When you use the && operator, if the first tested expression 
is false, the second expression is never evaluated because its value does not matter. 





The || operator also uses short-circuit evaluation. In other words, because only one of the 
Boolean expressions in an | | expression must be true to cause the dependent statements 

to execute, if the expression to the left of the | | is true, then there is no need to evaluate 
the expression to the right of the | |. (The same is true for nested ifs, as you can see in 
Figure 5-16.) When you use the | | operator, if the first tested expression is true, the second 
expression is never evaluated because its value does not matter. 


If you are using simple comparisons as the operands for the && or || operators, as in the 
examples in Figures 5-15 and 5-16, you won't notice that short-circuit evaluation is occurring. 
However, suppose that you have created two methods that return Boolean values and you 
use calls to those methods in an if statement, as in the following: 


if(method1Q && method2(Q)) 
System.out.printInC"OK") ; 


Depending on the actions performed within the methods, it might be important to 
understand that in this case, if method1() is false, then method2() will not execute. 


ee ; ; 
= Watch the video Using && and | |. 





Using Logical AND and OR Operators 


1. The AND operator is written as two ampersands ( && ), and the OR operator is 
written as two pipes ( | | ). 


2. When you use the && and | | operators, you must include a complete Boolean 
expression on each side. 


3. When you use an && or | | operator, each Boolean expression that surrounds the 
operator is always tested in order from left to right. 
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v You Do It 


Using the && Operator 263 








This section helps you create a program that demonstrates how short-circuiting 
works with the && operator. 


1. Open a new file in your text editor, and type the header and curly braces for a 
class named ShortCircuitTestAnd: 


public class ShortCircuitTestAnd 
{ 
} 


2. Between the curly braces for the class, type the header and braces for a 
main() method: 


public static void main(String[] args) 
{ 
} 


3. Within the main® method, insert an if..else statement that tests the return 
values of two method calls. If both methods are true, then “Both are true” is 
displayed. Otherwise, “Both are not true” is displayed. 


if(trueMethod() && falseMethod()) 
System.out.printInC"Both are true") ; 
else 
System.out.printInC"Both are not true"); 


4. Following the closing curly brace for the mainQ method, but before the 
closing curly brace for the class, insert a method named trueMethod(). The 
method displays the message “True method” and returns a true value. 


public static boolean trueMethod() 


{ 
System.out.printInC"True method") ; 
return true; 


} 


5. Following the closing curly brace of trueMethod(), insert a method named 
falseMethod() that displays the message “False method” and returns a 
false value. 


public static boolean falseMethodQ() 

{ 
System.out.printInC"False method") ; 
return false; 


(continues) 
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Making Decisions 


(continued) 


6. Save the file as ShortCircuitTestAnd.java, and then compile and execute it. 
Figure 5-17 shows the output. First, “True method” is displayed because 
264 trueMethod()was executed as the first half of the Boolean expression in the 
program’s if statement. Then, the second half of the Boolean expression calls 
falseMethod(). Finally, “Both are not true” is displayed because both halves of 
the tested expression were not true. 





Es Command Prompt 


CiN\Java>java ShortCircuitTestAnd 
True method 

False method 

Both are not true 


Co NJava> 











Figure 5-17 Execution of ShortCircuitTestAnd program 


7. Change the position of the method calls in the if statement so that the 
statement becomes the following: 


if(falseMethodQ && trueMethodQ) 
System.out.printInC"Both are true"); 
else 
System.out.printInC"Both are not true"); 


8. Save the file, compile it, and execute it. Now the output looks like Figure 5-18. 
The if statement makes a call to falseMethod(), and its output is displayed. 
Because the first half of the Boolean expression is false, there is no need to test 
the second half, so trueMethod@ never executes, and the program proceeds 
directly to the statement that displays “Both are not true.” 

(continues) 
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(continued) 


Es Command Prompt 


265 








CiNJava?java ShortCircuitTestAnd 
False method 
Both are not true 


CoNJavasT 





Figure 5-18 Output of ShortCircuitTestAnd after reversing Boolean expressions 


9. Change the class name to ShortCircuitTestOr, and immediately save the file 
as ShortCircuitTestOr.java. Replace the && operator with the || operator. 
Compile and execute the program with trueMethod()to the right of the | | 
operator and falseMethod()to its left. Then, reverse the positions of the 
methods, and compile and execute the program again. Make sure that you 
understand the output each way. 


Making Accurate and Efficient Decisions 


When new programmers must make a range check, they often introduce incorrect or 
inefficient code into their programs. In this section, you learn how to make accurate 
and efficient range checks, and you also learn how to use the && and || operators 
appropriately. 


Making Accurate Range Checks 


A range check is a series of statements that determine to which of several consecutive series 
of values another value falls. Consider a situation in which salespeople can receive one of 
three possible commission rates based on their sales. For example, a sale totaling $1,000 or 
more earns the salesperson an 8% commission, a sale totaling $500 through $999 earns 6% 
of the sale amount, and any sale totaling $499.99 or less earns 5%. Using three separate 

if statements to test single Boolean expressions might result in some incorrect commission 
assignments. For example, examine the code shown in Figure 5-19. 
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| final double HIGH_LIM = 1000.00; 
final double HIGH_RATE = 0.08; 
final double MED_LIM = 500.00; 
final double MED_RATE = 0.06; 
final double LOW_LIM = 499.99; 
final double LOW_RATE = 0.05; 










saleAmount >= 
HIGH_LIM? 
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commissionRate = 


ifCsaleAmount >= HIGH_LIM) 
HIGH_RATE 


commissionRate = HIGH_RATE; 
ifCsaleAmount >= MED_LIM) 

commissionRate = MED_RATE; 
ifCsaleAmount <= LOW_LIM) 

commissionRate = LOW_RATE; 











saleAmount 
>= MED_LIM? 


Don't Do It 
A high saleAmount 


commissionRate = 
MED_RATE 


will result in a medium 
rate commission. 








saleAmount <= 
LOW_LIM? 


commissionRate = 
LOW_RATE 








Figure 5-19 Incorrect commission-determining code 


Using the code shown in Figure 5-19, when a saleAmount is $5,000, for example, the 
first if statement executes, and the Boolean expression (saleAmount >= HIGH_LIM) 
evaluates as true, so HIGH_RATE is correctly assigned to commissionRate. However, 
the next if expression, (saleAmount >= MED_LIM), also evaluates as true, so the 
commissionRate, which was just set to HIGH_RATE, is incorrectly reset to MED_RATE. 


A partial solution to this problem is to use an else statement following the first evaluation, 
as shown in Figure 5-20. 
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final double HIGH_LIM = 1000.00; 
final double HIGH_RATE = 0.08; 
saleAmount >= final double MED_LIM = 500.00; 
HIGH_LIM? final double MED_RATE = 0.06; 
final double LOW_LIM = 499.99; 
commissionRate = final double LOW_RATE = 0.05; 267 
saleAmount HIGH_RATE 
>= MED_LIM? ifCsaleAmount >= HIGH_LIM) 
commissionRate = HIGH_RATE; 
else 








commissionRate = 


MED_RATE ifCsaleAmount >= MED_LIM) 


commissionRate = MED_RATE; 
ifCsaleAmount <= LOW_LIM) 
commissionRate = LOW_RATE; 


saleAmount <= Don’t Do It 
LOW_LIM? This question has 
already been answered. 


commissionRate = 
LOW_RATE 





Figure 5-20 Improved, but inefficient, commission-determining code 


With the new code in Figure 5-20, when the saleAmount is $5,000, the expression 
(saleAmount >= HIGH _LIM) is true and the commissionRate becomes HIGH_RATE; then 
the entire if structure ends. When the saleAmount is not greater than or equal to $1,000 
(for example, $800), the first if expression is false, and the else statement executes and 
correctly sets the commissionRate to MED_RATE. 


The code shown in Figure 5-20 works, but it is somewhat inefficient. When the saleAmount is 
any amount over LOW_RATE, either the first if sets commissionRate to HIGH_RATE for amounts 
that are at least $1,000, or its else sets commissionRate to MED_RATE for amounts that are 
at least $500. In either of these two cases, the Boolean value tested in the next statement, 
if(saleAmount <= LOW_LIM), is always false, so commissionRate retains its correct value. 
However, it was unnecessary to ask the LOW_LIM question. 


After you know that saleAmount is not at least MED_LIM, rather than asking if(saleAmount 
<= LOW_LIM), it’s easier, more efficient, and less error-prone to use an else. If the saleAmount 
is not at least HIGH_LIM and is also not at least MED_LIM, it must by default be less than or 
equal to LOW_LIM. Figure 5-21 shows this improved logic. Notice that the LOW_LIM constant 
is no longer declared because it is not needed anymore—if a saleAmount is not greater than 
or equal to MED_LIMIT, the commissionRate must receive the LOW_RATE. 
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final double HIGH_LIM = 1000.00; 
final double HIGH_RATE = 0.08; 
final double MED_LIM = 500.00; 
final double MED_RATE = 0.06; 
final double LOW_RATE = 0.05; 












saleAmount >= 
HIGH_LIM? 


if(saleAmount >= HIGH_LIM) 
commissionRate = HIGH_RATE; 
else 
if(saleAmount >= MED_LIM) 
commissionRate = MED_RATE; 
else 
commissionRate = LOW_RATE; 
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commissionRate = 
HIGH_RATE 






saleAmount >= 
MED_LIM? 





commissionRate = 
MED_RATE 


commissionRate = 
LOW_RATE 








Figure 5-21 Improved and efficient commission-determining logic 


Making Efficient Range Checks 


Within a nested 7f..e1se, like the one shown in Figure 5-21, it is most efficient to ask the 
question that is most likely to be true first. In other words, if you know that most saleAmount 
values are high, compare saleAmount to HIGH_LIM first. That way, you most frequently avoid 
asking multiple questions. If, however, you know that most saleAmounts are small, you 
should ask if(saleAmount < LOW_LIM) first. The code shown in Figure 5-22 results in the 
same commission value for any given saleAmount, but this sequence of decisions is more 
efficient when most saleAmount values are small. 





final double HIGH_RATE = 
final double MED_LIM = 1 
final double MED_RATE = 
final double LOW_LIM = 5 
final double LOW_RATE = 


0.08; 
00.00; 
.06; 
0.00; 
-05; 







saleAmount < 


LOW_LIM? 
commissionRate = 
LOW_RATE 


ooo o> 


if(saleAmount < LOW_LIM) 
commissionRate = LOW_RATE; 
else 
if(saleAmount < MED_LIM) 
commissionRate = MED_RATE; 
else 
commissionRate = HIGH_RATE; 





saleAmount < 
MED_LIM? 


commissionRate = 
HIGH_RATE 







commissionRate = 
MED_RATE 











Figure 5-22 Commission-determining code asking about smallest saleAmount first 
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In Figure 5-22, notice that the comparisons use the < operator instead of <=. That’s because 
a saleAmount of $1,000.00 should result in a HIGH_RATE, and a saleAmount of $500.00 
should result in a MED_RATE. If you wanted to use <= comparisons, then you could change 
the MED_LIM and LOW_LIM cutoff values to 999.99 and 499.99, respectively. 
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Using && and | | Appropriately 


Beginning programmers often use the && operator when they mean to use ||, and often 
use || when they should use && Part of the problem lies in the way we use the English 
language. For example, your boss might request, “Display an error message when an 
employee’s hourly pay rate is under $5.85 and when an employee’s hourly pay rate is 
over $60.” You define $5.85 as a named constant LOW and $60 as HIGH. However, because 
your boss used the word and in the request, you might be tempted to write a program 
statement like the following: 


if(payRate < LOW & payRate > HIGH) 


System.out.printIn("Error in pay rate"); This message can never be output because 


the Boolean expression can never be true. 


However, as a single variable, no payRate value can ever be both below 5.85 and over 60 at 
the same time, so the output statement can never execute, no matter what value the payRate 
has. In this case, you must write the following code that uses the || operator to display the 
error message under the correct circumstances: 


if(payRate < LOW || payRate > HIGH) 
System.out.printinC"Error in pay rate"); 


Similarly, your boss might request, “Display the names of those employees in departments 1 
and 2.” Because the boss used the word and in the request, you might be tempted to write the 
following: 


if(department == 1 && department == 2) 
System.out.printInC"Name is: " + name); 


However, the variable department can never contain both a J and a 2 at the same time, so no 
employee name will ever be output, no matter what the value of department is. The correct 
statement chooses employees whose department is 1 or 2, as follows: 


if(department == 1 || department == 2) 
System.out.printInC"Name is: " + name); 


Another type of mistake occurs if you use a single ampersand or pipe when you try to indicate 
a logical AND or OR. Both & and | are valid Java operators, but they have two different 
functions. When you use a single & or | with integer operands, it operates on bits. When you 
use a single & or | with Boolean expressions, it always evaluates both expressions instead of 
using short-circuitry. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 5 Making Decisions 


Making Accurate and Efficient Decisions 


1. Arange check is a series of statements that determine within which of a set of 


270 
ranges a value falls. 





2. When you must make a series of decisions in a program, it is most efficient to 
first ask the question that is most likely to be true. 


3. The statement if(payRate < 6.00 && payRate > 50.00) can be used to 
select payRate values that are higher or lower than the specified limits. 
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Using the switch Statement 


By nesting a series of if and else statements, you can choose from any number of 
alternatives. For example, suppose you want to display a student’s class year based on a 
stored number. Figure 5-23 shows one possible implementation of the program. 


if(year == 1) 
System.out.printInC"Freshman") ; 
else 
if(year == 2) 
System.out.printInC"Sophomore") ; 
else 


if(year == 3) 
System.out.printInC"Junior") ; 
else 
if(year == 4) 
System.out.printInC"Senior") ; 
else 


System.out.printInC"Invalid year"); 





Figure 5-23 Determining class status using nested if statements 


Visual Basic programming language) would code each else and the 7f clause that follows it on the same 
line, and refer to the format as an el se...if clause. Because Java ignores whitespace, the logic is the same 
whether each else and the subsequent if are on the same line or different lines. 


QG In program segments like the one in Figure 5-23, many programmers (particularly those familiar with the 
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An alternative to using the series of nested if statements shown in Figure 5-23 is to use the 
switch statement. The switch statement is useful when you need to test a single variable 
against a series of exact integer (including int, byte, and short types), character, or string 
values. The ability to use strings as the tested values in a switch statement is a new feature 
in Java 7. 
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The switch statement uses four keywords: 


e switch starts the structure and is followed immediately by a test expression enclosed 
in parentheses. 


e case is followed by one of the possible values for the test expression and a colon. 
e break optionally terminates a switch statement at the end of each case. 


e default optionally is used prior to any action that should occur if the test variable 
does not match any case. 


Figure 5-24 shows the switch statement used to display the four school years based on an 
integer named year. 


switch(year) 
{ 
case 1: 
System.out.printInC"Freshman") ; 
break; 
case 2: 


System.out.printInC"Sophomore") ; 
break; 


case 3: 
System.out.printInC"Junior"); 
break; 

case 4: 
System.out.printInC"Senior"); 
break; 

default: 
System.out.printInC"Invalid year"); 





Figure 5-24 Determining class status using a switch statement 


You are not required to list the case values in ascending order, as shown in Figure 5-24, 
although doing so often makes a statement easier to understand. For efficiency, you might 
want to list the most likely case first. 


The switch statement shown in Figure 5-24 begins by evaluating the year variable shown 
in the first line. If year is equal to the first case value, which is 1, the statement that displays 
“Freshman” executes. The break statement bypasses the rest of the switch structure, and 
execution continues with any statement after the closing curly brace of the switch structure. 
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If the year variable is not equivalent to the first case value of 1, the next case value is 
compared, and so on. If the year variable does not contain the same value as any of the 
case statements, the default statement or statements execute. 


You can leave out the break statements in a switch structure. However, if you omit the break 
and the program finds a match for the test variable, all the statements within the switch 
statement execute from that point forward. For example, if you omit each break statement 
in the code shown in Figure 5-24, when the year is 3, the first two cases are bypassed, but 
Junior, Senior, and Invalid year all are output. You should intentionally omit the break 
statements if you want all subsequent cases to execute after the test variable is matched. 
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You do not need to write code for each case in a switch statement. For example, suppose that 
the supervisor for departments 1, 2, and 3 is Jones, but other departments have different 
supervisors. In that case, you might use the code in Figure 5-25. 


int department; 

String supervisor; 

// Statements to get department go here 
switch(department) 

{ 


case 1: 
case 2: 
case 3: 
supervisor = "Jones"; 


break; 
case 4: 
supervisor "Staples"; 
break; 
case 5: 
supervisor "Tejano"; 
break: 
default: 
System.out.printInC"Invalid department code"); 





Figure 5-25 Using empty case statements so the same result occurs in multiple cases 


On the other hand, you might use strings in a switch structure to determine whether a 
supervisor name is valid, as shown in the method in Figure 5-26. 
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Using the switch Statement D0 


public static boolean isValidSupervisor(String name) 


{ 


boolean isValid; 

switch(name) 

{ 273 
case "Jones": 
case "Staples": 








case "Tejano": 
isValid = true; 
break; 
default: 
isValid = false; 


} 


return isValid; 





Figure 5-26 A method that uses a switch structure with string values 


When several char variables must be checked and you want to ignore whether they are 
uppercase or lowercase, one frequently used technique employs empty case statements, as in 
Figure 5-27. 


switch(departmentCode) 
{ 
case ‘a': 
case 'A': 
departmentName "Accounting"; 
break; 


case 'm': 

case 'M': 
departmentName = "Marketing"; 
break; 

// and so on 





Figure 5-27 Using a switch structure to ignore character case 


You are never required to use a switch structure; you can always achieve the same results 
with nested if statements. The switch structure is simply convenient to use when there are 
several alternative courses of action that depend on a single integer, character, or string value. 
In addition, it makes sense to use switch only when a reasonable number of specific matching 
values need to be tested. 


ee 
SN Watch the video Using the switch Statement. 
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Using the switch Statement 


274 1. When you must make more decisions than Java can support, you use a switch 
statement instead of nested if..else statements. 





2. The switch statement is useful when you need to test a single variable against a 
series of exact integer or character values. 


3. A break statement bypasses the rest of its switch structure, and execution 
continues with any statement after the closing curly brace of the switch 
structure. 
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aN You Do It 


Using the switch Statement 


In this section, you alter the AssignVolunteer3 program to add more options for 
donation types, and then use a switch statement to assign the appropriate volunteer. 


1. Open the AssignVolunteer3.java file that you created in a “You Do It” section 
earlier in this chapter. Change the class name to AssignVolunteer4, and 
immediately save the file as AssignVolunteer4.java. 


2. Keep the declaration CLOTHING_CODE, but replace the OTHER_CODE declaration 
with three new ones: 


final int FURNITURE_CODE = 2; 
final int ELECTRONICS CODE = 3; 
final int OTHER_CODE = 4; 


3. Retain the two pricing volunteer declarations, but add two new ones: 


final String FURNITURE_PRICER = "Walter"; 
final String ELECTRONICS PRICER = "Lydia"; 


(continues) 
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(continued) 


4. Replace the output statement that asks the user to enter 1 or 2 with the 
following simpler statement: 


System.out.printC"Enter an integer... ""); 275 








In a professional program, you might want to present the user with details 
about all the options, but this example keeps the prompt simple to save you 
from excessive typing. 


5. Replace the existing if..else structure with the following switch 
structure: 


switch(donationType) 
{ 

case(CLOTHING_CODE): 
volunteer = CLOTHING _PRICER; 
message = "a clothing donation"; 
break; 

case(FURNITURE_CODE) : 
volunteer = FURNITURE_PRICER; 
message = "a furniture donation"; 
break; 

case(ELECTRONICS_ CODE): 
volunteer = ELECTRONICS PRICER; 
message = "an electronics donation"; 
break; 

case(OTHER_CODE): 
volunteer = OTHER_PRICER; 
message = "another donation type"; 
break; 

default: 
volunteer = "invalid"; 
message = "an invalid donation type" ; 


} 


6. Save the file, and then compile and execute it. Figure 5-28 shows a typical 
execution. 


(continues) 
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C:\Java>java AssignUolunteer4 
What type of donation is this? 
Enter an integer... 3 

entered 3 


is an electronics donation 
The volunteer who will price this item is Lydia 


Cz\Java> 











Figure 5-28 Typical execution of the AssignVolunteer4 program 


Using the Conditional and NOT Operators 


Besides using if statements and switch structures, Java provides one more way to make 
decisions. The conditional operator requires three expressions separated with a question 
mark and a colon and is used as an abbreviated version of the if..else structure. As with 
the switch structure, you are never required to use the conditional operator; it is simply a 
convenient shortcut. The syntax of the conditional operator is: 


testExpression ? trueResult : falseResult; 


The first expression, testExpression, is a Boolean expression that is evaluated as true or 
false. If it is true, the entire conditional expression takes on the value of the expression 
following the question mark (trueResult). If the value of the testExpression is false, 
the entire expression takes on the value of falseResult. 


You have seen many examples of binary operators such as == and && The conditional operator is a 
ternary operator—one that needs three operands. Through Java 6, the conditional operator is the only 
ternary operator in Java, so it is sometimes referred to as “the” ternary operator. Java 7 introduces a 
collapsed version of the ternary operator that checks for nul 1 values assigned to objects. The new 
operator is called the Elvis operator because it uses a question mark and colon together (?:); if you view 
it sideways, it reminds you of Elvis Presley. 





For example, suppose you want to assign the smallest price to a sale item. Let the variable a be 
the advertised price and the variable b be the discounted price on the sale tag. The expression 
for assigning the smallest cost is: 


smallerNum = (a < b) ? a: b; 
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When evaluating the expression a < b, where a is less than b, the entire conditional 
expression takes the value to the left of the colon, a, which then is assigned to smallerNum. 
If a is not less than b, the expression assumes the value to the right of the colon, b, and b 
is assigned to smallerNum. 


You could achieve the same results with the following if..else structure: 
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if(a < b) 
smallerNum = a; 
else 
smallerNum = b; 


The advantage of using the conditional operator is the conciseness of the statement. 


Using the NOT Operator 


You use the NOT operator, which is written as the exclamation point ( ! ), to negate the result 
of any Boolean expression. Any expression that evaluates as true becomes false when 
preceded by the NOT operator, and accordingly, any false expression preceded by the NOT 
operator becomes true. 


For example, suppose a monthly car insurance premium is $200 if the driver is age 25 
or younger and $125 if the driver is age 26 or older. Each of the if...else statements in 
Figure 5-29 correctly assigns the premium values. 





ifCage <= 25) 
premium = 200; 
else 
premium = 125; 


if(age >= 26) 
premium = 125; 
else 
premium = 200; 


ifC! Cage <= 25)) 
premium = 125; 
else 
premium = 200; 


ifC! Cage >= 26)) 
premium = 200; 
else 
premium = 125; 








Figure 5-29 Four if...el1se statements that all do the same thing 


In Figure 5-29, the statements with the ! operator are somewhat harder to read, particularly 
because they require the double set of parentheses, but the result of the decision-making 
process is the same in each case. Using the ! operator is clearer when the value of a Boolean 
variable is tested. For example, a variable initialized as boolean oldEnough = (age >= 25); 
can become part of the relatively easy-to-read expression if (!01dEnough).... 
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Using the Conditional and NOT Operators 


1. The conditional operator is used as an abbreviated version of the if..else 
structure and requires two expressions separated with an exclamation point. 


The NOT operator is written as the exclamation point ( ! ). 


The value of any false expression becomes true when preceded by the NOT 
operator. 
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Understanding Operator Precedence 


You can combine as many && or | | operators as you need to make a decision. For example, 
if you want to award bonus points (defined as BONUS) to any student who receives a perfect 
score on any of four quizzes, you might write a statement like the following: 


if(scorel == PERFECT || score2 == PERFECT || 
score3 == PERFECT || score4 == PERFECT) 
bonus = BONUS; 
else 
bonus = 0; 


In this case, if at least one of the score variables is equal to the PERFECT constant, the student 
receives the bonus points. 


Although you can combine any number of && or | | operations in an expression, special care 
must be taken when you mix them. You learned in Chapter 2 that arithmetic operations 
have higher and lower precedences, and an operator’s precedence makes a difference in how 
an expression is evaluated. For example, within an arithmetic expression, multiplication and 
division are always performed prior to addition or subtraction. Table 5-1 shows the 
precedence of the operators you have used so far. 





Understanding Operator Precedence D0 











Precedence Operator(s) Symbol(s) 
Highest Logical NOT ! 
Intermediate Multiplication, division, modulus * /[ % 
Addition, subtraction + - 279 
Relational > < >= <= 
Equality == I= 
Logical AND && 
Logical OR || 
Conditional 2 
Lowest Assignment = 


1E)) (35 Operator precedence for operators used so far 


In general, the order of precedence agrees with common algebraic usage. For example, in any 
mathematical expression, such as x = a + b, the arithmetic is done first and the assignment is 
done last, as you would expect. The relationship of && and | | might not be as obvious. The && 
operator has higher precedence than the || operator. For example, consider the program 
segments shown in Figure 5-30. These code segments are intended to be part of an insurance 
company program that determines whether an additional premium should be charged to a 
driver who meets both of the following criteria: 


e Has more than two traffic tickets or is under 25 years old 


e Is male 





// Assigns extra premiums incorrectly 






ifCtrafficTickets > 2 || age < 25 && gender == 'M') 
extraPremium = 


// Assigns extra premiums correctly 


ifCCtrafficTickets > 2 || age < 25) && gender == 'M') 
extraPremium = 200; 





The && operator 
is evaluated first 


The expression within 
the inner parentheses 
is evaluated first. 








Figure 5-30 Two comparisons using && and | | 


in alphabetical order. 


Q One way to remember the precedence of the AND and OR operators is to remember that they are evaluated 
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Consider a 30-year-old female driver with three traffic tickets; according to the stated criteria, 

she should not be assigned the extra premium because she is not male. With the first if 

statement in Figure 5-30, the && operator takes precedence, so age < 25 && gender == 'M' is 

evaluated first. The value is false because age is not less than 25, so the expression is reduced 

to trafficTickets > 2 or false. Because the value of the tickets variable is greater than 2, 

280 the entire expression is true, and $200 is assigned to extraPremium, even though it should 
not be. 





In the second if statement shown in Figure 5-30, parentheses have been added so the | | 
operator is evaluated first. The expression trafficTickets > 2 || age < 25 is true because 
the value of trafficTickets is 3. So the expression evolves to true && gender == 'M'. 
Because gender is not ‘M’, the value of the entire expression is false, and the extraPremium 
value is not assigned 200, which is correct. Even when an expression would be evaluated 

as you intend without adding extra parentheses, you can always add them to help others 
more easily understand your programs. 


The following two conventions are important to keep in mind: 
e The order in which you use operators makes a difference. 


e You can always use parentheses to change precedence or make your intentions clearer. 


Understanding Operator Precedence 


1. Assume p, q, and r are all Boolean variables that have been assigned the value 
true. After the following statement executes, the value of p is still true. 
p= !q || 6; 

2. Assume p, q, and r are all Boolean variables that have been assigned the value 
true. After the following statement executes, the value of p is still true. 
p = !C!q & !r); 

3. Assume p, q, and r are all Boolean variables that have been assigned the value 
true. After the following statement executes, the value of p is still true. 
p=! [| !r); 
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Adding Decisions and Constructors to Instance Methods 


You frequently will want to use what you have learned about decision making to control 
the allowed values in objects’ fields. Whether values are assigned to objects by constructors 
or by mutator methods, you often will need to use decisions to control values. 


For example, suppose that you create an Employee class as shown in Figure 5-31. The class 281 
contains two fields that hold an employee ID number and pay rate. The constructor accepts 

values for these fields as parameters, but instead of simply assigning the parameters to the 

fields, the code determines whether each value is within the allowed limits for the field. 

Similar logic could be used in any set methods created for the class. Using decisions helps 

you ensure that fields have acceptable values. 








public class Employee 

{ 
private int empNum; 
private double payRate; 
public int MAX_EMP_NUM = 9999; 
public double MAX_RATE = 60.00; 
EmployeeCint num, double rate) 


{ 


ifCnum <= MAX_EMP_NUM) 
empNum = num; 
else 
empNum = MAX_EMP_NUM; 
if(payRate <= MAX_RATE) 


payRate = rate; 
else 
payRate = 0; 
} 
public int getEmpNum() 
{ 


} 
public double getPayRate() 
{ 


} 


return empNum; 


return payRate; 





Figure 5-31 The Employee class that contains a constructor that makes decisions 
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282 Adding Decisions to Constructors and Instance Methods 





In this section, you modify the DogTriathlonParticipant Class you created in 
Chapter 4. Because some points are awarded for participation in each event, a 
score of 0 is not possible unless a dog did not participate. In the existing class, 
the constructor accepts the number of events in which a dog participated and 
the participant’s score in each event. Currently, there is no way to check 
whether these values are in agreement. Now, you can modify the class so that 
the number of events matches the number of valid scores supplied to the con- 
structor. 


1. Open the DogTriathlonParticipant.java file that you created in Chapter 4. 
Change the class name to DogTriathlonParticipant2, and immediately save 
the file as DogTriathlonParticipant2.java. 


2. Change the constructor name to DogTriathlonParticipant2. 


3. If Ois assigned to the number of events in the existing program, computing 
the average score produces a nonnumeric result. Now that you know how to 
use decisions, you can fix this problem. In place of the arithmetic statement 
that produces the average score using division, use the following if...else 
structure: 
if (NUM_EVENTS == 0) 

avg =0; 
else 
avg = (double) total / NUM_EVENTS; 


4. Adda Boolean field to the list of class fields. This field holds true if the 
number of events reported matches the number of nonzero scores. Other- 
wise, the field holds false: 


private boolean scoresAgree; 


5. There are several ways to ensure that the number of events passed to the 
constructor matches the number of nonzero scores passed. One way is to 
add 1 to a total for each nonzero score and then determine whether that total 
equals the passed number of events. To accomplish this, first add the 
following code to the constructor immediately after the statements that 
assign values to the name and number of events. These statements declare a 
variable that holds the number of nonzero scores passed to the constructor, 
and then add 1 to the variable for each nonzero event score: 


(continues) 
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(continued) 


int totalNotO = 0; 
if(scorel != 0) 

totalNotO = totalNot0O + 1; 283 
if(score2 != 0) 

totalNotO = totalNot0O + 1; 
if(score3 != 0) 

totalNotO = totalNot0O + 1; 


6. Compare the number of events to the total of nonzero scores, and set the 
Boolean variable scores Agree: 








if (CnumEvents == totalNot0) 
scoresAgree = true; 
else 
scoresAgree = false; 


7. Replace the statements that unconditionally assigned values to obedienceScore, 
conformationScore, and agilityScore with the following if..else structure, 
which assigns the constructor’s parameters to the three scores only when 
scoresAgree IS true. 


if (scoresAgree) 


{ 


obedienceScore = scorel; 
conformationScore = score2; 
agilityScore = score3; 

} 

else 

{ 
obedienceScore = 0; 
conformationScore = 0; 
agilityScore = 0; 

} 

8. In the display© method for the DogTriathlonParticipant2 class, add the 
following statement that displays a special notice if an error occurred in the 
number of events value. 
if(! scoresAgree) 

System.out.printInC"Notice! Number of events for " + 
name + " does not agree with scores reported."); 


9. Save the file and compile it. 


10. Open the TestDogs.java file that you created in a “You Do It” section in 
Chapter 4. Rename the class TestDogs2, and immediately save the file as 
TestDogs2.java. 


(continues) 
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11. 


12. 


13. 





(continued) 


Change DogTriathlonParticipant tO DogTriathlonParticipantz in the six 
places it occurs in the three object declarations. 


Change the object declarations so that the number of events and the number 
of nonzero scores used as constructor arguments agree for some objects 
but not for others. 


Save the file, and then compile and execute it. Figure 5-32 shows a typical 
execution in which one participant’s entries are valid but the other two 
contain errors. 


f= Command Prompt 


Cs\Java>java TestDogs2 


Bowser participated in @ events and has an average score of 6.6 

Bowser has a total score of @ bringing the total cumulative score to 
Rush participated in 2 events and has an average score of 76.0 

Rush has a total score of 146 bringing the total cumulative score to 


INoticet Number of events for Ginger does not agree with scores reported. 
Ginger participated in 2 events and has an average score of @.0 
Ginger has a total score of @ bringing the total cumulative score to 


iC: 


\Java> 





* Number of events for Bowser does not agree with scores reported. 





Figure 5-32 Execution of TestDogs2 program 


14. 


15. 


deemed that any suppressed content does not materially affect the overall lear 


Change the values in the TestDogs2 program. Recompile and reexecute the 
program several times to ensure that using various combinations of number 
of events and event scores produces appropriate results. 


On your own, modify the DogTriathlonParticipant2 class and rename it 
DogTriath1on3. In this version, do not use a count of the nonzero score 
parameters to determine whether the number of events matches the number 
of valid scores used as arguments. Instead, use only decisions to ensure that 
the parameters are in agreement. Save the file as DogTriathlon3.java, and 
create a file named TestDogs3.java that you can use to test the class. 

Be sure to test every possible combination of constructor parameters in the 
TestDogs3 Class—for example, when the events parameter is 2, it is correct 
whether the nonzero scores are the first and second, the first and third, or 
the second and third. 
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Don't Do It 


e Don’t ignore subtleties in boundaries used in decision making. For example, selecting 
employees who make less than $20 an hour is different from selecting employees who 
make $20 an hour or less. 


e Don't use the assignment operator instead of the comparison operator when testing 
for equality. 


e Don’t insert a semicolon after the Boolean expression in an if statement; insert the 
semicolon after the entire statement is completed. 


e Don't forget to block a set of statements with curly braces when several statements 
depend on the if or the else statement. 


e Don’t forget to include a complete Boolean expression on each side of an && or | | 
operator. 


e Don't try to use a switch structure to test anything other than an integer, character, 
or string value. 


e Don't forget a break statement if one is required by the logic of your switch 
structure. 


e Don't use the standard relational operators to compare objects; use them only with the 
built-in Java types. In the chapter Characters, Strings, and the StringBuilder, you will 
learn how to compare Strings correctly, and in the chapter Advanced Inheritance 
Concepts you will learn to compare other objects. 
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Key Terms 


Pseudocode is a tool that helps programmers plan a program’s logic by writing plain English 
statements. 


A flowchart is a tool that helps programmers plan a program’s logic by writing the steps 
in diagram form, as a series of shapes connected by arrows. 


A sequence structure is a logical structure in which one step follows another 
unconditionally. 


A decision structure is a logical structure that involves choosing between alternative courses 
of action based on some value within a program. 


True or false values are Boolean values; every computer decision results in a 
Boolean value. 
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CHAPTER 5 Making Decisions 


In Java, the simplest statement you can use to make a decision is the if statement; you use it 
to write a single-alternative decision. 


The equivalency operator ( == ) compares values and returns true if they are equal. 


An empty statement contains only a semicolon. 
286 





A single-alternative if is a decision structure that performs an action, or not, based on 
one alternative. 


A dual-alternative if is a decision structure that takes one of two possible courses of 
action. 


In Java, the if..else statement provides the mechanism to perform one action when a 
Boolean expression evaluates as true and to perform a different action when a Boolean 
expression evaluates as false. 


The if clause of an if..else statement is the part that executes when the evaluated 
Boolean expression is true. 


The else clause of an if..else statement is the part that executes when the evaluated 
Boolean expression is false. 


A nested if statement contains an if structure within another if structure. 


The logical AND operator uses two Boolean expressions as operands and evaluates to true 
if both operands are true. The AND operator is written as two ampersands ( && ). 


The logical OR operator uses two Boolean expressions as operands and evaluates to true 
if either operand is true. The OR operator is written as two pipes ( || ). 


Short-circuit evaluation describes the feature of the AND and OR operators in which 
evaluation is performed only as far as necessary to make a final decision. 


A range check is a series of statements that determine within which of a set of ranges a value 
falls. 


An else...if clause is a format used in nested if statements in which each instance of 
else and its subsequent if are placed on the same line. 


The switch statement uses up to four keywords to test a single variable against a series 
of exact integer or character values. The keywords are switch, case, break, and default. 








The conditional operator requires three expressions separated with a question mark and a 
colon and is used as an abbreviated version of the if..e1se structure. 


A ternary operator is one that needs three operands. 


You use the NOT operator, which is written as the exclamation point ( ! ), to negate the result 
of any Boolean expression. 
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Chapter Summary 


e Making a decision involves choosing between two alternative courses of action based on 
some value within a program. 








e You can use the if statement to make a decision based on a Boolean expression that 287 
evaluates as true or false. If the Boolean expression enclosed in parentheses within an if 
statement is true, the subsequent statement or block executes. A single-alternative if 
performs an action based on one alternative; a dual-alternative if, or if..else, provides 
the mechanism for performing one action when a Boolean expression is true and a 
different action when the expression is false. 


e To execute more than one statement that depends on the evaluation of a Boolean 
expression, you use a pair of curly braces to place the dependent statements within a 
block. Within an if or an else statement, you can code as many dependent statements as 
you need, including other if and else statements. 


e Nested if statements are particularly useful when two conditions must be met before 
some action occurs. 


e You can use the AND operator ( && ) within a Boolean expression to determine whether 
two expressions are both true. You use the OR operator ( | | ) when you want to carry out 
some action even if only one of two conditions is true. 


e New programmers frequently cause errors in their if statements when they perform a 
range check incorrectly or inefficiently, or when they use the wrong operator while trying 
to make an AND or OR decision. 


e You use the switch statement to test a single variable against a series of exact integer, 
character, or string values. 


e The conditional operator requires three expressions, a question mark, and a colon and is 
used as an abbreviated version of the if...e1se statement. The NOT operator ( ! ) negates 
the result of any Boolean expression. 


e Operator precedence makes a difference in how expressions are evaluated. You can always 
use parentheses to change precedence or make your intentions clearer. 


e Decisions are frequently used to control field values in constructors and mutator 
methods. 







Review Questions 


1. The logical structure in which one instruction occurs after another with no 
branching is a 





a. sequence c. loop 
b. selection d. case 
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Which of the following is typically used in a flowchart to indicate a decision? 


a. square c. diamond 
b. rectangle d. oval 


Which of the following is not a type of if statement? 





a. single-alternative if c. reverse if 
b. dual-alternative if d. nested if 
A decision is based on a(n) value. 

a. Boolean c. definitive 
b. absolute d. convoluted 


In Java, the value of (4 > 7) is 





a. 4 c. true 
b. 7 d. false 


Assuming the variable q has been assigned the value 3, which of the following 
statements displays XXX? 

a. if(q > 0) System.out.print]nC"XXX"); 

b. if(q > 7); System.out.printIn("XXX"); 

c. Both of the above statements display XXX. 

d. Neither of the above statements displays XXX. 


What is the output of the following code segment? 


t = 10; 

if(t > 7) 

{ 
System.out.printC"AAA") ; 
System.out.print("BBB"); 

} 

a. AAA c. AAABBB 

b. BBB d. nothing 


What is the output of the following code segment? 


t = 10; 
if(t > 7) 
System.out.printC"AAA") ; 
System.out.print("BBB"); 
a. AAA c. AAABBB 
b. BBB d. nothing 
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10. 


11. 


12. 


13. 


14. 
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Review Questions iii 


What is the output of the following code segment? 





t= 7; 

if(t > 7) 
System.out.printC"AAA") ; 
System.out.print("BBB") 


a. AAA c. AAABBB 
b. BBB d. nothing 
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When you code an if statement within another if statement, as in the following, 
then the if statements are 





if(a > b) 

if(c > d)x = 0; 
a. notched c. nested 
b. nestled d. sheltered 


The operator that combines two conditions into a single Boolean value that is 
true only when both of the conditions are true, but is false otherwise, 





is 
a. $$ cy ill 
b. 1! d. && 


The operator that combines two conditions into a single Boolean value that is true 
when at least one of the conditions is true is 


a ($$ ce || 
V1 d. && 





Assuming a variable f has been initialized to 5, which of the following statements 
sets g to 0? 

if(f > 6 || f == 5) g = 0; 

if(F <3 || f> 4) g=0; 

if(f >= 0 || f < 2) g = 0; 

All of the above statements set g to 0. 







ao fF 2 


Which of the following groups has the lowest operator precedence? 


a. relational c. addition 
b. equality d. logical OR 


CHAPTER 5 Making Decisions 


290 













15. 


16. 


17. 


18. 


19; 


Which of the following statements correctly outputs the names of voters who live 

in district 6 and all voters who live in district 7? 

a. if (district == 6 || 7) 
System.out.printinC"Name is 

b. if(district == 6 || district == 7) 
System.out.printInC"Name is " + name); 

c. if (district = 6 && district == 7) 
System.out.printInC"Name is " + name); 

d. two of these 


+ name); 


Which of the following displays “Error” when a student ID is less than 1000 or 
more than 9999? 


a. if CstuId < 1000) if(stuId > 9999) 
System.out.printInC"Error") ; 
b. if(stuId < 1000 && stuId > 9999) 
System.out.printInC"Error") ; 
c. if CstuId < 1000) 
System.out.printInC"Error") ; 
else 
if(stuId > 9999) 
System.out.printInC"Error") ; 


d. Two of these are correct. 





You can use the statement to terminate a switch structure. 
a. switch c. case 
b. end d. break 


The argument tested in a switch structure can be any of the following except 
a(n) 


a. int c. double 





b. char d. String 
Assuming a variable w has been assigned the value 15, what does the following 
statement do? 

= 15 ?x=2: x =0; 


a. assigns 15 to w c. assigns 0 to x 
b. assigns 2 to x d. nothing 
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20. Assuming a variable y has been assigned the value 6, the value of !(y < 7) 











is 
a. 6 c. true 
b. 7 d. false 
291 
Exercises 


(=) Programming Exercises 


1. Write an application that asks a user to enter an integer. Display a statement that 
indicates whether the integer is even or odd. Save the file as EvenOdd.java. 


2. Write an application that prompts the user for the day’s high and low temperatures. If 
the high is greater than or equal to 90 degrees, display the message, “Heat warning.” If 
the low is less than 32 degrees, display the message “Freeze warning.” If the difference 
between the high and low temperatures is more than 40 degrees, display the message, 
“Large temperature swing.” Save the file as Temperatures.java. 


3. a. Write an application for the Summerdale Condo Sales office; the program 
determines the price of a condominium. Ask the user to choose 1 for park view, 
2 for golf course view, or 3 for lake view. The output is the name of the chosen 
view as well as the price of the condo. Park view condos are $150,000, condos with 
golf course views are $170,000, and condos with lake views are $210,000. If the 
user enters an invalid code, set the price to 0. Save the file as CondoSales.java. 


b. Adda prompt to the CondoSales application to ask the user to specify a (1) garage 
or a (2) parking space, but only if the condo view selection is valid. Add $5,000 to 
the price of any condo with a garage. If the parking value is invalid, display an 
appropriate message and assume that the price is for a condo with no garage. Save 
the file as CondoSales2.java. 


4, a. The Williamsburg Women’s Club offers scholarships to local high school students 
who meet any of several criteria. Write an application that prompts the user for a 
student’s numeric high school grade point average (for example, 3.2), the student’s 
number of extracurricular activities, and the student’s number of service activities. 
Display the message “Scholarship candidate” if the student has any of the 
following: 












e A grade point average of 3.8 or above and at least one extracurricular activity 
and one service activity 


e A grade point average below 3.8 but at least 3.4 and a total of at least three 
extracurricular and service activities 


e Agrade point average below 3.4 but at least 3.0 and at least two extracurricular 


activities and three service activities 
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If the student does not meet any of the qualification criteria, display “Not a 
candidate.” Save the file as Scholarship.java. 


b. Modify the Scholarship application so that if a user enters a grade point average 
under 0 or over 4.0, or a negative value for either of the activities, an error message 


292 appears. Save the file as Scholarship2.java. 





5. Write an application that displays a menu of three items for the Jivin’ Java Coffee 
Shop as follows: 


(1) American 1.99 
(2) Espresso 2.50 
(3) Latte 2.15 


Prompt the user to choose an item using the number (1, 2, or 3) that corresponds to 
the item, or to enter 0 to quit the application. After the user makes the first selection, 
if the choice is 0, display a total bill of $0. Otherwise, display the menu again. The user 
should respond to this prompt with another item number to order or 0 to quit. If the 
user types 0, display the cost of the single requested item. If the user types J, 2, or 3, 
add the cost of the second item to the first, and then display the menu a third time. If 
the user types 0 to quit, display the total cost of the two items; otherwise, display the 
total for all three selections. Save the file as Coffee.java. 


6. Barnhill Fastener Company runs a small factory. The company employs workers who 
are paid one of three hourly rates depending on skill level: 





Skill Level Hourly Pay Rate (S$) 
1 17.00 | 
2 20.00 
3 22.00 







Each factory worker might work any number of hours per week; any hours over 40 are 
paid at one and one-half times the usual rate. 


In addition, workers in skill levels 2 and 3 can elect the following insurance 
options: 
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Option Explanation Weekly Cost to Employee ($) 
i Medical insurance 32.50 
2 Dental insurance 20.00 
3 Long-term disability insurance 10.00 293 








Also, workers in skill level 3 can elect to participate in the retirement plan at 3% of 
their gross pay. 


Write an interactive Java payroll application that calculates the net pay for a factory 
worker. The program prompts the user for skill level and hours worked, as well as 
appropriate insurance and retirement options for the employee’s skill level category. 
The application displays: (1) the hours worked, (2) the hourly pay rate, (3) the regular 
pay for 40 hours, (4) the overtime pay, (5) the total of regular and overtime pay, and 
(6) the total itemized deductions. If the deductions exceed the gross pay, display an 
error message; otherwise, calculate and display (7) the net pay after all the deductions 
have been subtracted from the gross. Save the file as Pay.java. 


7. Create a class for Shutterbug’s Camera Store, which is having a digital camera 
sale. The class is named DigitalCamera, and it contains data fields for a brand, 
the number of megapixels in the resolution, and price. Include a constructor that 
takes arguments for the brand and megapixels. If the megapixel parameter is 
greater than 10, the constructor sets it to 10. The sale price is set based on the 
resolution; any camera with 6 megapixels or fewer is $99, and all other cameras 
are $129. Also include a method that displays DigitalCamera details. Write an 
application named TestDigitalCamera in which you instantiate at least four 
objects, prompt the user for values for the camera brand and number of 
megapixels, and display all the values. Save the files as DigitalCamera.java and 
TestDigitalCamera.java. 


8. Create a class for the Parks Department in Cloverdale. The class is named Park, 
and it contains a String field for the name of the park, an integer field for the 
size in acres, and four Boolean fields that hold whether the park has each of 
these features: picnic facilities, a tennis court, a playground, and a swimming 
pool. Include get and set methods for each field. Include code in the method 
that sets the number of acres and does not allow a negative number or a 
number over 400. Save the file as Park.java. 














Then, create a program with methods that do the following: 


e Accepts a Park parameter and returns a Boolean value that indicates whether the 
Park has both picnic facilities and a playground. 


e Accepts a Park parameter and four Boolean parameters that represent requests 
for the previously mentioned Park features. The method returns true if the Park 
has all the requested features. 
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10. 


e Accepts a Park parameter and four Boolean parameters that represent requests 
for the previously mentioned Park features. The method returns true if the Park 
has exactly all the requested features and no others. 


e Accepts a Park parameter and returns the number of facilities that the Park 
features. 


e Accepts two Park parameters and returns the larger Park. 


Declare at least three Park objects, and demonstrate that all the methods work 
correctly. Save the program as TestPark.java. 


a. Create a class named Invoice that holds an invoice number, balance due, and 
three fields representing the month, day, and year when the balance is due. 
Create a constructor that accepts values for all five data fields. Within the 
constructor, assign each argument to the appropriate field with the following 
exceptions: 


e Ifan invoice number is less than 1000, force the invoice number to 0. 

e Ifthe month field is less than 1 or greater than 12, force the month field to 0. 
e Ifthe day field is less than 1 or greater than 31, force the day field to 0. 

e Ifthe year field is less than 2011 or greater than 2017, force the year field to 0. 


In the Invoice class, include a display method that displays all the fields on an 
Invoice object. Save the file as Invoice.java. 


b. Write an application containing a main() method that declares several Invoice 
objects, proving that all the statements in the constructor operate as specified. 
Save the file as TestInvoice.java. 


c. Modify the constructor in the Invoice class so that the day is not greater than 31, 
30, or 28, depending on the month. For example, if a user tries to create an 
invoice for April 31, force it to April 30. Also, if the month is invalid, and 
thus forced to 0, also force the day to 0. Save the modified Invoice class as 
Invoice2.java. Then modify the TestInvoice class to create Invoice2 objects. 
Create enough objects to test every decision in the constructor. Save this file 
as TestInvoice2.java. 


Use the Web to locate the lyrics to the traditional song “The Twelve Days of 
Christmas.” The song contains a list of gifts received for the holiday. The list is 
cumulative so that as each “day” passes, a new verse contains all the words of the 
previous verse, plus a new item. Write an application that displays the words to 
the song starting with any day the user enters. (Hint: Use a switch statement 
with cases in descending day order and without any break statements so that 
the lyrics for any day repeat all the lyrics for previous days.) Save the file as 
TwelveDays.java. 
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& Debugging Exercises 


1. Each of the following files in the Chapter05 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and fix 
the program. After you correct the errors, save each file using the same filename 295 
preceded with Fix. For example, save DebugFivel.java as FixDebugFivel java. 








a. DebugFiveljava c. DebugFive3.java 
b. DebugFive2.java d. DebugFive4.java 


oy Game Zone 


1. In Chapter 1, you created a class called RandomGuess. In this game, players guess a 
number, the application generates a random number, and players determine 
whether they were correct. Now that you can make decisions, modify the application 
so it allows a player to enter a guess before the random number is displayed and 
then displays a message indicating whether the player’s guess was correct, too 
high, or too low. Save the file as RandomGuess2.java. (After you finish the next 
chapter, you will be able to modify the application so that the user can continue to 
guess until the correct answer is entered.) 


2. Create a lottery game application. Generate three random numbers (see Appendix D 
for help in doing so), each between 0 and 9. Allow the user to guess three numbers. 
Compare each of the user’s guesses to the three random numbers and display a 
message that includes the user’s guess, the randomly determined three-digit number, 
and the amount of money the user has won as follows: 










Matching Numbers Award ($) 
Any one matching 10 
Two matching 100 
Three matching, not in order 1,000 
Three matching in exact order 1,000,000 
No matches 0 


Make certain that your application accommodates repeating digits. For example, if a 
user guesses 1, 2, and 3, and the randomly generated digits are 1, 1, and 1, do not 
give the user credit for three correct guesses—just one. Save the file as Lottery.java. 
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In Chapter 3, you created a Card class. Modify the Card class so the setValue() 
method does not allow a Card’s value to be less than 1 or higher than 13. If the 
argument to setValue() is out of range, assign 1 to the Card’s value. 


In Chapter 3, you also created a PickTwoCards application that randomly selects 
two playing cards and displays their values. In that application, all Card objects 
arbitrarily were assigned a suit represented by a single character, but they could 
have different values, and the player observed which of two Card objects had the 
higher value. Now, modify the application so the suit and the value both are chosen 
randomly. Using two Card objects, play a very simple version of the card game War. 
Deal two Cards—one for the computer and one for the player—and determine the 
higher card, then display a message indicating whether the cards are equal, the 
computer won, or the player won. (Playing cards are considered equal when they 
have the same value, no matter what their suit is.) For this game, assume the Ace 
(value 1) is low. Make sure that the two Cards dealt are not the same Card. For 
example, a deck cannot contain more than one Card representing the 2 of spades. 
If two cards are chosen to have the same value, change the suit for one of them. 
Save the application as War.java. (After you study the chapter Arrays, you will be 
able to create a more sophisticated War game in which you use an entire deck 
without repeating cards.) 


In Chapter 4, you created a Die class from which you could instantiate an object 
containing a random value from 1 through 6. You also wrote an application that 
randomly “throws” two dice and displays their values. Modify the application so it 
determines whether the two dice are the same, the first has a higher value, or the 
second has a higher value. Save the application as TwoDice2.java. 


In the game Rock Paper Scissors, two players simultaneously choose one of three 
options: rock, paper, or scissors. If both players choose the same option, then the 
result is a tie. However, if they choose differently, the winner is determined as 
follows: 


e Rock beats scissors, because a rock can break a pair of scissors. 
e Scissors beats paper, because scissors can cut paper. 
e Paper beats rock, because a piece of paper can cover a rock. 


Create a game in which the computer randomly chooses rock, paper, or scissors. 
Let the user enter a number 1, 2, or 3, each representing one of the three choices. 
Then, determine the winner. Save the application as RockPaperScissors.java. 

(In the chapter Characters, Strings, and the StringBuilder, you will modify the 
game so that the user enters a string for rock, paper, and scissors, rather than just 
entering a number.) 
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Qa: Case Problems 


Carly’s Catering provides meals for parties and special events. In Chapters 3 
and 4, you created an Event class for the company. Now, make the following 297 
changes to the class: 








e Currently, the class contains a field that holds the price for an Event. Now 
add another field that holds the price per guest, and add a public method 
to return its value. 


e Currently, the class contains a constant for the price per guest. Replace that 
field with two fields—a lower price per guest that is $32, and a higher price 
per guest that is $35. 


e Addanew method named isLargeEvent() that returns true if the number 
of guests is 50 or greater and otherwise returns false. 


e Modify the method that sets the number of guests so that a large 
Event (over 50 guests) uses the lower price per guest to set the new 
pricePerGuest field and calculate the total Event price. A small Event 
uses the higher price. 


Save the file as Event.java. 


b. In Chapter 4, you modified the EventDemo class to demonstrate two Event 
objects. Now, modify that class again as follows: 


e Instantiate three Event objects, and prompt the user for values for each 
object. 


e Change the method that displays Event details to use the new 
isLargeEvent() method and the new price per guest value. Use the 
display method with all three objects. 


e Create a method that accepts two Event objects and returns the larger one 
based on number of guests. (If the Events have the same number of guests, 
you can return either object.) Call this method three times—once with 
each pair of instantiated Events—and display the event number and 
number of guests for each argument as well as the event number and 
number of guests for the larger Event. 









Save the file as EventDemo.java. 
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CHAPTER 5 Making Decisions 


2. a. Sammy’s Seashore Supplies rents beach equipment such as kayaks, canoes, 
beach chairs, and umbrellas to tourists. In Chapters 3 and 4, you created a 
Rental class for the company. 


Now, make the following change to the class: 


298 e Currently, a rental price is calculated as $40 per hour plus $1 for each 
minute over a full hour. This means that a customer who rents equipment 
for 41 or more minutes past an hour pays more than a customer who waits 
until the next hour to return the equipment. Change the price calculation so 
that a customer pays $40 for each full hour and $1 for each extra minute up 
to and including 40 minutes. 





Save the file as Rental.java. 


b. In Chapter 4, you modified the RentalDemo class to demonstrate a Rental 
object. Now, modify that class again as follows: 


e Instantiate three Rental objects, and prompt the user for values for each 
object. Display the details for each object to verify that the new price 
calculation works correctly. 


e Create a method that accepts two Rental objects and returns the one with 
the longer rental time. (If the Rentals have the same time, you can return 
either object.) Call this method three times—once with each pair of 
instantiated Rentals—and display the contract number and time in hours 
and minutes for each argument as well as the contract number of the 
longer Rental. 


Save the file as RentalDemo.java. 
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Looping 


In this chapter, you will: 


Learn about the loop structure 


(©) 


Create whi le loops 


(©) 


Use shortcut arithmetic operators 


(©) 


Create for loops 


(©) 


Create do...whi le loops 


(©) 


Nest loops 


(©) 
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Learning About the Loop Structure 


If making decisions is what makes programs seem smart, looping is what makes programs 
seem powerful. A loop is a structure that allows repeated execution of a block of statements. 
Within a looping structure, a Boolean expression is evaluated. If it is true, a block of 
statements called the loop body executes and the Boolean expression is evaluated again. The 
loop body can be a single statement or a block of statements between curly braces. As long as 
the expression is true, the statements in the loop body continue to execute. When the 
Boolean evaluation is false, the loop ends. One execution of any loop is called an iteration. 
Figure 6-1 shows a diagram of the logic of a loop. 


In Java, you can use several mechanisms to 
create loops. In this chapter, you learn to 
use three types of loops: 





e Awhile loop, in which the loop- 
controlling Boolean expression is the 
first statement in the loop 





Boolean 7 loop body 


expression 








e A for loop, which is usually used as a falee 
concise format in which to execute 
loops 
e A do.while loop, in which the loop- Figure 6-1 Flowchart of a loop structure 


controlling Boolean expression is the 
last statement in the loop 





Learning About the Loop Structure 


1. Aloop is a structure that allows repeated execution of a block of statements as 
long as a tested expression is true. 


2. lf aloop’s tested Boolean expression is true, a block of statements called the 
loop body executes before the Boolean expression is evaluated again. 


3. When the Boolean evaluation tested in a loop becomes false, the loop body 
executes one last time. 
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Creating while Loops 


You can use a while loop to execute a body of statements continually as long as the Boolean 
expression that controls entry into the loop continues to be true. In Java, a while loop 

consists of the keyword whi 1e followed by a Boolean expression within parentheses, followed 

by the body of the loop. 301 








You can use a while loop when you need to perform a task either a predetermined or 
unpredictable number of times. A loop that executes a specific number of times is a definite 
loop, or a counted loop. On the other hand, the number of times the loop executes might not 
be determined until the program is running. Such a loop is an indefinite loop because you 
don’t know how many times it will eventually loop. 


Writing a Definite whi 1e Loop 


To write a definite loop, you initialize a loop control variable, a variable whose value 
determines whether loop execution continues. While the Boolean value that results from 
comparing the loop control variable and another value is true, the body of the while loop 
continues to execute. In the body of the loop, you must include a statement that alters the 
loop control variable. For example, the program segment shown in Figure 6-2 displays 
the series of integers 1 through 10. The variable val is the loop control variable—it starts 
the loop holding a value of 1, and while the value remains under 11, val continues to be 
output and increased. 





int val; 
final int LIMIT = 11; 


val = 1; 
while(val < LIMIT) 
{ 


System.out.printin(val); 
val = val + 1; 











Figure 6-2 Awhile loop that displays the integers 1 through 10 


When you write applications containing loops, it is easy to make mistakes. For example, 
executing the code shown in Figure 6-3 causes the message “Hello” to be displayed forever 

(theoretically) because there is no code to end the loop. A loop that never ends is called an 
infinite loop. 
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Don't Do It 
This loop never will end 
because the tested 
expression is always 
while(4 > 2) true. 
{ 


} 


System.out.printInC"Hello"); 


Figure 6-3 A loop that displays “Hello” infinitely 


G 
G 


An infinite loop might not actually execute infinitely. Depending on the tasks the loop performs, eventually the 
computer memory might be exhausted (literally and figuratively) and execution might stop. Also, it’s possible 
that the processor has a time-out feature that forces the loop to end. Either way, and depending on your 
system, quite a bit of time could pass before the loop stops running. 


As an inside joke to programmers, the address of Apple Computer, Inc. is One Infinite Loop, Cupertino, 
California. 


In Figure 6-3, the expression 4 > 2 evaluates to true. You obviously never need to make such 
an evaluation, but if you do so in this while loop, the body of the loop is entered and “Hello” 
is displayed. Next, the expression is evaluated again. The expression 4 > 2 is still true, so 
the body is entered again. “Hello” is displayed repeatedly; the loop never finishes because 

4 > 2 is never false. 


It is a bad idea to write an infinite loop intentionally. However, even experienced 
programmers write them by accident. So, before you start writing loops, it is good to know 
how to exit from an infinite loop. You might suspect an infinite loop if the same output is 
displayed repeatedly, or if the screen simply remains idle for an extended period of time 
without displaying expected output. If you think your application is in an infinite loop, you 
can press and hold Ctrl, and then press C or Break; the looping program should terminate. 
(On many keyboards, the Break key is also the Pause key.) 


To prevent a while loop from executing infinitely, three separate actions must occur: 


e A loop control variable is initialized to a starting value. 


e The loop control variable is tested in the while statement. 


e The loop control variable is altered within the body of the loop. The variable must be 
altered so that the test expression can eventually evaluate to false and the loop can end. 
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All of these conditions are met by the example in Figure 6-4. First, a loop control variable 
loopCount is named and set to a value of 1. Second, the statement while(loopCount < 3) is 
tested. Third, the loop body is executed because the loop control variable loopCount is less 
than 3. Note that the loop body shown in Figure 6-4 consists of two statements made into a 
block by their surrounding curly braces. The first statement displays “Hello,” and then the 
second statement adds 1 to loopCount. The next time loopCount is evaluated, it is 2. It is still 
less than 3, so the loop body executes again. “Hello” is displayed a second time, and 
loopCount becomes 3. Finally, because the expression loopCount < 3 now evaluates to false, 
the loop ends. Program execution then continues with any subsequent statements. 
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Loop control variable initialized 
loopCount = 1; 
cen ocenene < 3) Loop control variable tested 


System. out.printInC"Hello") ; 


loopCount = loopCount + 1; Loop control variable altered 


} 






loopCount = 1 


loopCount 
< 3? 


false 







loopCount = 
loopCount + 1 








Figure 6-4 Awhile loop that displays “Hello” twice 


Pitfall: Failing to Alter the Loop Control Variable Within 
the Loop Body 


It is important that the loop control variable be altered within the body of the loop. Figure 6-5 
shows the same code as in Figure 6-4, but the curly braces have been eliminated. In this case, 
the while loop body ends at the semicolon that appears at the end of the “Hello” statement. 
Adding 1 to the loopCount is no longer part of a block that contains the loop, so the value of 
loopCount never changes, and an infinite loop is created. 
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loopCount = 1; Don't Do It 

whileCloopCount 7 3) ‘i " Loop control variable is 
System. out.print]nC"Hel lo") ; not altered in the loop. 
loopCount = loopCount + 1; 


304 This indentation has 


no effect. 





loopCount = 


loopCount 
< 3? 


loopCount = 
loopCount + 1 





Figure 6-5 Awhile loop that displays “Hello” infinitely because 1oopCount is not altered in the 
loop body 


Pitfall: Creating a Loop with an Empty Body 


As with the decision-making if statement that you learned about in Chapter 5, placement 
of the statement-ending semicolon is important when you work with the while statement. 
If a semicolon is mistakenly placed at the end of the partial statement while(loopCount < 3);, 
as shown in Figure 6-6, the loop is also infinite. This loop has an empty body, or a body 
with no statements in it. So, the Boolean expression is evaluated, and because it is true, 

the loop body is entered. Because the loop body is empty, no action is taken, and the 
Boolean expression is evaluated again. Nothing has changed, so it is still true, the empty 
body is entered, and the infinite loop continues. 
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Don't Do It 
This semicolon causes 
the loop to have an 


loopCount = 1; empty body. 


whileCloopCount < 3); 
{ 
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System.out.printInC"Hello"); 
loopCount = loopCount + 1; 


} 











Je. 


< 3? 


loopCount 
loopCount + 1 








Figure 6-6 Awhile loop that loops infinitely with no output because the loop body is empty 


Altering a Definite Loop’s Control Variable 


A definite loop is a counter-controlled loop because the loop control variable is changed 

by counting. It is very common to alter the value of a loop control variable by adding 1 to it, 
or incrementing the variable. However, not all loops are controlled by adding 1. The loop 
shown in Figure 6-7 displays “Hello” twice, just as the loop in Figure 6-4 does, but its loop 
is controlled by subtracting 1 from a loop control variable, or decrementing it. 


loopCount = 3; 
whileCloopCount > 1) 
{ 


System.out.printInC"Hello"); 
loopCount = loopCount - 1; 





Figure 6-7 Awhile loop that displays “Hello” twice, decrementing the loopCount variable in the 
loop body 
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In the program segment shown in Figure 6-7, the variable loopCount begins with a value 

of 3. The loopCount is greater than 1, so the loop body displays “Hello” and decrements 

loopCount to 2. The Boolean expression in the while loop is tested again. Because 2 is 

more than 1, “Hello” is displayed again, and loopCount becomes 1. Now loopCount is 

not greater than 1, so the loop ends. There are many ways to execute a loop two times. 

306 For example, you can initialize a loop control variable to 10 and continue while the value 
is greater than 8, decreasing the value by 1 each time you pass through the loop. 
Similarly, you can initialize the loop control variable to 12, continue while it is greater 
than 2, and decrease the value by 5 each time. In general, you should not use such 
unusual methods to count repetitions because they simply make a program confusing. 
To execute a loop a specific number of times, the clearest and best method is to start 
the loop control variable at 0 or 1, increment by 1 each time through the loop, and stop 
when the loop control variable reaches the appropriate limit. 





workable approach. However, many seasoned programmers start counter values at 0 because they are 
used to doing so when working with arrays. When you study arrays in the chapter Introduction to Arrays, you 
will learn that their elements are numbered beginning with 0. 


Q When you first start programming, it seems reasonable to initialize counter values to 1, and that is a 


ee 
= Watch the video Looping. 


Writing an Indefinite whi 1e Loop 


You are not required to alter a loop control variable by adding to it or subtracting from it. 
Often, the value of a loop control variable is not altered by arithmetic, but instead is 
altered by user input. Instead of being a counter-controlled loop, an indefinite loop is an 
event-controlled loop. That is, an event occurs that determines whether the loop continues. 
An event-controlled loop is a type of indefinite loop because you don’t know how many times 
it will eventually repeat. For example, perhaps you want to continue performing some task as 
long as the user indicates a desire to continue by pressing a key. In this case, while you are 
writing the program, you do not know whether the loop eventually will be executed two 
times, 200 times, or at all. 


Consider an application in which you ask the user for a bank balance and then ask 
whether the user wants to see the balance after interest has accumulated. Each time the 
user chooses to continue, an increased balance appears, reflecting one more year of 
accumulated interest. When the user finally chooses to exit, the program ends. The 
program appears in Figure 6-8. 
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import java.util.Scanner; 
public class BankBalance 
{ 
public static void main(String[] args) 
{ 307 
double balance; 
int response; 
int year = 1; 
final double INT_RATE = 0.03; 
Scanner keyboard = new Scanner(System.in) ; 
System.out.printC"Enter initial bank balance > "); 
balance = keyboard.nextDouble(); 
System.out.printInC"Do you want to see next year's balance?"); 
System.out.printC"Enter 1 for yes"); 
System.out.print¢" or any other number for no >> "); 








response = keyboard.nextIntQ; 
whileCresponse == 1) 


{ 


balance = balance + balance * INT_RATE; 
System.out.printInC"After year " + year + " at " + INT_RATE + 
" interest rate, balance is $" + balance); 

year + 1; 

.out.printInC"\nDo you want to see the balance " + 

the end of another year?"); 

.out.printC"Enter 1 for yes"); 

.out.printc” or any other number for no >> "); 
response = keyboard.nextInt(); 





Figure 6-8 The BankBalance application 


expected data types. If not, an error occurs and the program terminates. You will learn to manage user entry 


In the BankBalance program, as in any interactive program, the user must enter data that has the 
Y errors in the chapter Exception Handling. 


The program shown in Figure 6-8 declares needed variables and a constant for a 3 percent 

interest rate, and then asks the user for a balance. The application then asks the user to enter 
a 1 if the user wants see the next year’s balance. As long as the user wants to continue, the 

application continues to display increasing bank balances. 


The loop in the application in Figure 6-8 begins with the line that contains: 
whileCresponse == 1) 


If the user enters any integer value other than J, the loop body never executes; instead, the 
program ends. However, if the user enters J, all the statements within the loop body execute. 
The application increases the balance by the interest rate value, displays the new balance, 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 6 Looping 


adds 1 to year, and asks whether the user wants another balance. The last statement in the 
loop body accepts the user’s response. After the loop body executes, control returns to the top 


308 





of the loop, where 


the Boolean expression in the while loop is tested again. If the user’s 


response is 1, the loop is entered and the process begins again. Figure 6-9 shows the output of 
the BankBalance application after the user enters a $575.00 starting balance and responds 
with J five times to the prompt for increased interest payments before responding 2. 





Gi 


Do you want to 
1 for yes 
year 1 at 


Do you want to 
1 for yes 
year 2 at 


Do you want to 
Enter 1 for yes 
After year 3 at 


Do you want to 
Enter 1 for yes 
After year 4 at 


Do you want to 
Enter 1 for yes 
After year 5 at 


Do you want to 
yes 


fay Command Prompt 


C:\Java>java BankBalance 
Enter initial bank balance > 575 


see next year’s balance? 
or any other number for no >> 1 
@.@3 interest rate, balance is $592.25 


see the balance at the end of another year? 
or any other number for no >> 1 
@.@3 interest rate, balance is $610.01 


see the balance at the end of another year? 
or any other number for no >> 1 
@.@3 interest rate, balance is $628.31 


see the balance at the end of another year? 
or any other number for no >> 1 
@.@3 interest rate, balance is $647.15 


see the balance at the end of another year? 
or any other number for no >> 1 
@.@3 interest rate. balance is $666.56 


see the balance at the end of another year? 
or any other number for no >> 2 














Figure 6-9 Typical 


execution of the BankBalance application 


Validating Data 


Programmers commonly use indefinite loops when validating input data. Validating data is 
the process of ensuring that a value falls within a specified range. For example, suppose you 
require a user to enter a value no greater than 3. Figure 6-10 shows an application that does 
not progress past the data entry loop until the user enters a correct value. If the user enters 3 
or less at the first prompt, the shaded loop never executes. However, if the user enters a 
number greater than 3, the shaded loop executes, providing the user with another chance to 
enter a correct value. While the user continues to enter incorrect data, the loop repeats. 


Figure 6-11 shows 


a typical execution. 
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import java.util .Scanner; 
public class EnterSmal1Value 
{ 
public static void main(String[] args) 
{ 309 
int userEntry; 
final int LIMIT = 3; 
Scanner input = new Scanner(System. in); 
System.out.print("Please enter an integer no higher than " + 
LIMIT + "> "); 
userEntry = input.nextIntQ; 
whileCuserEntry > LIMIT) 
{ 








System.out.printInC"The number you entered was too high"); 
System.out.print("Please enter an integer no higher than " + 
LIMIT + "> "); 
userEntry = input.nextIntQ) ; 
Bi 


System.out.printInC"You correctly entered " + userEntry); 


DL J 





Figure 6-10 The EnterSmal1Value application 





a 
wecrnensrort 


C:\Java>java EnterSmallUalue 

Please enter an integer no higher than 
The number you entered was too high 
Please enter an integer no higher than 
The number you entered was too high 
Please enter an integer no higher than 
The number you entered was too high 
Please enter an integer no higher than 
You correctly entered 3 





C:\Java> 











Figure 6-11 Typical execution of the EnterSmal1Value program 


Figure 6-10 illustrates an excellent method for validating input. Before the loop is entered, the 
first input is retrieved. This first input might be a value that prevents any executions of the 
loop. This first input statement prior to the loop is called a priming read or priming input. 
Within the loop, the last statement retrieves subsequent input values for the same variable 
that will be checked at the entrance to the loop. 
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CHAPTER 6 Looping 


Novice programmers often make the mistake of checking for invalid data using a 
decision instead of a loop. That is, they ask whether the data is invalid using an if 
statement; if the data is invalid, they reprompt the user. However, they forget that a user 
might enter incorrect data multiple times. Usually, a loop is the best structure to use 
when validating input data. 


310 








aN You Do It 


Creating while Loops 


A finite loop executes a specific number of times; an indefinite loop is one that 
never ends. 


A well-written while loop contains an initialized loop control variable that is 
tested in the while expression and then altered in the loop body. 


In an indefinite loop, you don’t know how many times the loop will occur. 
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Writing a Loop to Validate Data Entries 


In Chapter 5, you created an AssignVolunteer4 application for Sacks Fifth Avenue, 
a nonprofit thrift shop. The application accepts a donation code and assigns the 
appropriate volunteer to price the item for sale. Now you add a loop to ensure that 
a valid code always is entered. 


i 


Open the AssignVolunteer4.java file that you created in Chapter 5. 
Change the class name to AssignVolunteer5, and immediately save the 
file as AssignVolunteer5.java. 


After the input statement that gets a code from the user, but before the 
switch structure that assigns a volunteer, insert the following loop. The loop 
continues while the input donationType Is less than the lowest valid code or 
higher than the highest valid code. (Recall that the values of CLOTHING_CODE, 
FURNITURE_CODE, ELECTRONICS_CODE, and OTHER_CODE are 1 through 4, 


(continues) 
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(continued) 
respectively.) Within the loop body, statements explain the error to the user and 
then get a new value for donationType. 


while(donationType < CLOTHING_CODE || donationType > OTHER_CODE) 311 
{ 








System.out.printInC"You entered " + donationType + 
"which is not a valid donation type") ; 
System.out.print("Please enter a value between " + 
CLOTHING_CODE + " and " + OTHER_CODE +"... "); 
System.out.printC"Enter an integer... "); 
donationType = input.nextInt() ; 
} 


3. Save the file, and compile and execute it. Figure 6-12 shows a typical execution 
in which a user enters an invalid code three times before entering a valid one. 





Ga 


fy Command Prompt 


C:\Java>java AssignUolunteerS 

What type of donation is this? 

Enter an integer... 26 

You entered 26 which is not a valid donation type 

Please enter a value between 1 and 4... Enter an integer... 
You entered 5 which is not a valid donation type 

Please enter a value between 1 and 4... Enter an integer... 
You entered @ which is not a valid donation type 

Please enter a value between 1 and 4... Enter an integer... 
You entered 2 

This is a furniture donation 

The volunteer who will price this item is Walter 


C:=\Java> 














Figure 6-12 Typical execution of the AssignVolunteer5S application 


4. Inthe current program, the default case assigns “invalid” to the volunteer. At this 
point, some professionals would advise that you remove the default case from 
the case structure because it is no longer possible for the user to enter an invalid 
code. Others would argue that leaving the default case in place serves two 
purposes. First, it provides documentation that clarifies the course of action if 
the entered code does not match any of the listed cases. Second, the program 
requirements might change in the future. For example, perhaps one of the 
categories will be eliminated. Then, if you remove the case instructions for that 
category, a default block will already be in place to handle the new error. 
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Using Shortcut Arithmetic Operators 


Programmers commonly need to increase the value of a variable in a program. As you saw 

in the previous section, many loops are controlled by continually adding 1 to some variable, 

as in count = count + 1;. Incrementing a variable in a loop to keep track of the number 
312 of occurrences of some event is also known as counting. Similarly, in the looping bank 
balance program shown in Figure 6-8, the program not only incremented the year variable 
by adding 1, it also increased a bank balance by an interest amount with the statement 
balance = balance + balance * INT_RATE;. In other words, the bank balance became its 
old value plus a new interest amount; the process of repeatedly increasing a value by some 
amount is known as accumulating. 





Because increasing a variable is so common, Java provides you with several shortcuts for 
incrementing and accumulating. The statement count += 1; is identical in meaning to 
count = count + 1. The += is the add and assign operator; it adds and assigns in one 
operation. Similarly, balance += balance * INT_RATE; increases a balance by the INT_RATE 
percentage. Besides using the shortcut operator +=, you can use the subtract and assign 
operator ( -= ), the multiply and assign operator ( *= ), the divide and assign operator ( /= ), 
and the remainder and assign operator ( %= ). Each of these operators is used to perform 
the operation and assign the result in one step. For example, balanceDue -= payment 
subtracts payment from balanceDue and assigns the result to balanceDue. 


When you want to increase a variable’s value by exactly 1, you can use two other shortcut 
operators—the prefix ++, also known as the prefix increment operator, and the postfix ++, 
also known as the postfix increment operator. To use a prefix ++, you type two plus signs 
before the variable name. The statement someValue = 6; followed by ++someValue; results 
in someValue holding 7—one more than it held before you applied the ++. To use a postfix ++, 
you type two plus signs just after a variable name. The statements anotherValue = 56; 
anotherValue++; result in anotherValue containing 57. Figure 6-13 shows four ways 

you can increase a value by 1; each method produces the same result. You are never 
required to use shortcut operators; they are merely a convenience. 


int value; 
value = 24; 
++value; // Result: value is 25 
value = 24; 


value++; // Result: value is 25 

value = 24; 

value = value + 1; // Result: value is 25 
value = 24; 

value += 1; // Result: value is 25 





Figure 6-13 Four ways to add 1 to a value 
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You can use the prefix ++ and postfix ++ with variables but not with constants. An 
expression such as ++84; is illegal because an 84 must always remain an 84. However, you 
can create a variable named val, assign 84 to it, and then write ++val; or val++; to increase 
the variable’s value. 








As you learned in Chapter 2, most arithmetic operators, such as those used for addition and multiplication, 
are binary operators—they operate on two values. Other examples of unary operators include the cast 
operator, as well as ( + ) and (-) when used to indicate positive and negative values. 


Q The prefix and postfix increment operators are unary operators because you use them with one value. 313 


When you simply want to increase a variable’s value by 1, there is no difference in the 
outcome, whether you use the prefix or postfix increment operator. For example, when value 
is set to 24 in Figure 6-13, both ++value and value++ result in value becoming 25; each 
operator results in increasing the variable by 1. However, when a prefix or postfix operator is 
used as part of a larger expression, it does make a difference which operator you use because 
they function differently in terms of what they return. When a prefix operator is used in an 
expression, the value after the calculation is used, but when a postfix operator is used in an 
expression, the value used is the one before the calculation takes place. 


When you use the prefix ++, the result is calculated, and then its value is used. For example, 
consider the following statements: 


b = 4; 
c = ++b; 


The result is that both b and c hold the value 5 because b is increased to 5 and then the value 
of the expression is assigned to c. 


When you use the postfix ++, the value of the expression before the increase is stored. For 
example, consider these statements: 


b = 4; 
c = b++; 


The result is still that b is 5, but c is only 4. Although b is increased, its original value is 
assigned to c. 


In other words, if b = 4, the value of b++ is also 4, but after the statement is completed, the 
value of b is 5. 


Figure 6-14 shows an application that illustrates the difference between how the prefix 
and postfix increment operators work. Notice from the output in Figure 6-15 that when 
the prefix increment operator is used on myNumber, the value of myNumber increases from 
17 to 18, and the result is stored in answer, which also becomes 18. After the value is 
reset to 17, the postfix increment operator is used; 17 is assigned to answer, and 
myNumber is incremented to 18. 
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public class IncrementDemo 
{ 
public static void main(String[] args) 
{ 
int myNumber, answer; 
myNumber = 17; 
System.out.printIn("Before incrementing, myNumber is " + 
myNumber) ; 
answer = ++myNumber; 
System.out.printInc"After prefix increment, myNumber is " + 
myNumber) ; 
System.out.printIn(" and answer is 
myNumber = 17; 
System.out.printIn("Before incrementing, myNumber is " + 
myNumber) ; 
answer = myNumber++; 
System.out.printInC"After postfix increment, myNumber is " + 
myNumber) ; 
System.out.printIn(C" and answer is " + answer); 


" 


+ answer); 











Figure 6-14 The IncrementDemo application 





Bl Commend te 


C:\Java>java Increment Demo 
Before incrementing. myNumber is 17 
* is 18 





ser 
ncerementing. myNumber is 17 
fix increment, myNumber is 18 
is 17 


C:\Java> 











Figure 6-15 Output of the IncrementDemo application 


Later in this chapter, you will learn another reason why you might want to use a prefix operator instead of a 
postfix operator. 


Choosing whether to use a prefix or postfix operator is important when one is part of a larger 
expression. For example, if d is 5, then 2 * ++d is 12, but 2 * d++ is 10. 


Similar logic can be applied when you use the prefix and postfix decrement operators. 
For example, ifb = 4 andc = b--, 4 is assigned to c, but b is decreased and takes the value 3. 
Ifb = 4andc = --b, b is decreased to 3 and 3 is assigned to c. 
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ee 
Eau Watch the video Using Shortcut Arithmetic Operators. 
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Using Shortcut Arithmetic Operators 








1. Assume that x = 4 and y = 5. The value of ++y + +4x is 11. 
2. Assume that x = 4 and y = 5. The value of y == x++ iS true. 
3. Assume that x = 4 and y = 5. The value of y += x is 9. 
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aN You Do It 


Working with Prefix and Postfix Increment Operators 


Next, you write an application that demonstrates how prefix and postfix operators are 
used to increment variables and how incrementing affects the expressions that 
contain these operators. 


1. Open anew text file, and begin a demonstration class named DemoIncrement 
by typing: 
public class DemoIncrement 
{ 


public static void main(String[] args) 


{ 


2. Onanewline, add a variable v, and assign it a value of 4. Then declare a 
variable named plusPlusv, and assign it a value of ++v by typing: 


intv=4; 
int plusPlusV = ++v; 


3. The last statement, int plusPlusV = ++v;, increases v to 5, so before 
declaring a vPlusP lus variable to which you assign v++, reset v to 4 by typing: 


v=4; 
int vPlusPlus = v++; 


(continues) 
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(continued) 


Add the following statements to display the three values: 


System.out.printInC"v is "+v); 
System.out.printin("++v is " + plusPlusV) ; 
System. out.printIn(C"v++ is " + vPlusPlus) ; 


Add the closing curly brace for the main() method and the closing curly brace 
for the DemoIncrement Class. Save the file as Demolncrement.java, then 
compile and execute the program. Your output should look like Figure 6-16. 











Figure 6-16 Output of the DemoIncrement class 


To illustrate how comparisons are made, add a few more variables to the 
DemoIncrement program. Change the class name to DemoIncrement2, and 
immediately save the file as Demolncrement2.java. 


After the last printIn@ statement, add three new integer variables and two new 
Boolean variables. The first Boolean variable compares ++w to y; the second 
Boolean variable compares x++ to y: 


intw=17, x=17, y=18; 
boolean comparel = (++w == y); 
boolean compare2 = (x++ == y); 


Add the following statements to display the values stored in the compare 
variables: 


System.out.printIn("First compare is " + comparel1) ; 
System.out.printIn("'Second compare is " + compare2) ; 


Save, compile, and run the program. The output appears in Figure 6-17. Make 
certain you understand why each statement displays the values it does. 
Experiment by changing the values of the variables, and see if you can predict 
the output before recompiling and rerunning the program. 


(continues) 
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fay Command Prompt 
_ li 


C:\Java>java DemoIncrement2 
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> 5 
a 


First compare is true 
Second compare is false 


C:z\Java> 





Figure 6-17 Output of the DemoIncrement2 application 


Creating a for Loop 


A for loop is a special loop that is used when a definite number of loop iterations is required; 
it provides a convenient way to create a counter-controlled loop. Although a while loop can 
also be used to meet this requirement, the for loop provides you with a shorthand notation 
for this type of loop. When you use a for loop, you can indicate the starting value for the loop 
control variable, the test condition that controls loop entry, and the expression that alters the 
loop control variable—all in one convenient place. 


You begin a for loop with the keyword for followed by a set of parentheses. Within the 
parentheses are three sections separated by exactly two semicolons. The three sections are 
usually used for the following: 


e Initializing the loop control variable 
e Testing the loop control variable 
e Updating the loop control variable 


The body of the for statement follows the parentheses. As with an if statement or a while 
loop, you can use a single statement as the body of a for loop, or you can use a block of 
statements enclosed in curly braces. Many programmers recommend that you always use a 
set of curly braces to surround the body of a for loop for clarity, even when the body 
contains only a single statement. You should use the conventions recommended by your 
organization. 


Assuming that a variable named val has been declared as an integer, then the for statement 
shown in Figure 6-18 produces the same output as the while statement shown below it— 
both display the integers 1 through 10. 
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for(val = 1; val < 11; ++val) 


{ 
System.out.printIn(val); 


318 i 





val = 1; 
while(val < 11) 
{ 


System.out.printIn(val); 
++val; 





Figure 6-18 A for loop and a whi 1e loop that display the integers 1 through 10 


Within the parentheses of the for statement shown in Figure 6-18, the first section prior to 
the first semicolon initializes val to 1. The program executes this statement once, no matter 
how many times the body of the for loop executes. 


After initialization, program control passes to the middle, or test section, of the for statement 
that lies between the two semicolons. If the Boolean expression found there evaluates to true, 
the body of the for loop is entered. In the program segment shown in Figure 6-18, val is set 
to 1, so when val < 11 is tested, it evaluates to true. The loop body displays val. In this 
example, the loop body is a single statement, so no curly braces are needed (although they 
could be added). 


After the loop body executes, the final one-third of the for loop that follows the second 
semicolon executes, and val is increased to 2. Following the third section in the for 
statement, program control returns to the second section, where val is compared to ll a 
second time. Because val is still less than 11, the body executes: val (now 2) is displayed, and 
then the third, altering portion of the for loop executes again. The variable val increases to 3, 
and the for loop continues. 


Eventually, when val is not less than 11 (after 1 through 10 have been displayed), the for loop 
ends, and the program continues with any statements that follow the for loop. Although the 
three sections of the for loop are most commonly used for initializing, testing, and 
incrementing, you can also perform the following tasks: 


e Initialization of more than one variable in the first section of the for statement by placing 
commas between the separate statements, as in the following: 


for(g = 0, h=1; g < 6; ++g) 


e Performance of more than one test using AND or OR operators in the second section, as 
in the following: 


for(g = 0; g < 3 && h > 1; ++g) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


e Decrementation or performance of some other task in the third section, as in the 
following: 
for(g = 5; g >= 1; --g) 


e Altering more than one variable in the third section, as in the following: 


for(g = 0; g < 10; ++g, ++h, sum += g) 319 








e You can leave one or more portions of a for loop empty, although the two semicolons are 
still required as placeholders. For example, if x has been initialized in a previous program 
statement, you might write the following: 


forc; x < 10; ++x) 


However, to someone reading your program, leaving a section of a for statement empty is 
less clear than using all three sections. 


In general, you should use the same loop control variable in all three parts of a for statement, 
although you might see some programs written by others in which this is not the case. You 
should also avoid altering the loop control variable in the body of the loop. If a variable is 
altered both within a for statement and within the block it controls, it can be very difficult to 
follow the program’s logic. This technique can also produce program bugs that are hard to 
find. Usually, you should use the for loop for its intended purpose—as a shorthand way of 
programming a definite loop. 


Occasionally, you will encounter a for loop that contains no body, such as the following: 
for(x = 0; x < 100000; ++x); 


This kind of loop exists simply to use time—that is, to occupy the central processing unit for 
thousands of processing cycles—when a brief pause is desired during program execution, for 
example. As with if and while statements, usually you do not want to place a semicolon at 
the end of the for statement before the body of the loop. Java also contains a built-in method 
to pause program execution. The sleep() method is part of the Thread class in the java.lang 
package, and you will learn how to use it as you continue to study Java. 


You also can declare a variable within a for statement, as in the following: 
for(int val = 1; val < 11; ++val) 


Programmers often use this technique when the variable is not needed in any other part 
of the program. If you declare a variable within a for statement, the variable can be used 
only in the block that depends on the for statement; when the block ends, the variable 
goes out of scope. 


Q Java also supports an enhanced for loop. You will learn about this loop in the chapter Introduction to Arrays. 


ee 
=. Watch the video Using the for Loop. 
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«a You Do It 


Creating a for Loop 


A for loop always must contain two semicolons within its parentheses. 
The body of a for loop might never execute. 


Within the parentheses of a for loop, the last section must alter the loop control 
variable. 
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Working with Definite Loops 


Suppose you want to find all the numbers that divide evenly into 100. You want to 
write a definite loop—one that executes exactly 100 times. In this section, you write a 
for loop that sets a variable to 1 and increments it to 100. Each of the 100 times 
through the loop, if 100 is evenly divisible by the variable, the application displays the 
number. 


ile 


One aueee AEH nara ane copied, scanned, 0 Meet 





Open a new text file. Begin the application named DivideEvenly by typing the 
following code. Use a named constant for the 100 value and a variable named 
var that will hold, in turn, every value from 1 through 100: 


public class DivideEvenly 


{ 
public static void main(String[] args) 


{ 
final int LIMIT = 100; 


int var; 
Type a statement that explains the purpose of the program: 
System.out.print(LIMIT + " is evenly divisible by "); 


Write the for loop that varies var from 1 through 100. With each iteration of 
the loop, test whether 100 % var is O. If you divide 100 by a number and there 
is no remainder, the number goes into 100 evenly. 


(continues) 
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(continued) 


for(var = 1; var <= LIMIT; ++var) 
ifCLIMIT % var == 0) 

System.out.print(var+""); 321 

// Display the number and a space 








4. Add an empty printIn@ statement to advance the insertion point to the next 
line by typing the following: 


System.out.printInQ ; 


5. Type the closing curly braces for the main© method and the DivideEvenly 
class. 


6. Save the program as DivideEvenly. Compile and run the program. Figure 6-19 
shows the output. 


= 
a consent 


C:\Java>java DivideEvenly 
166 is evenly divisible by 1 2 45 16 26 25 56 1066 








C=\Java> 











Figure 6-19 Output of the DivideEvenly application 


7. By definition, no value that is greater than half of LIMIT can possibly go into 
LIMIT evenly. Therefore, the loop in the DivideEvenly program could be 
made to execute faster if the loop executes while var is less than or equal to 
half of LIMIT. If you decide to make this change to the program, remember 
that you must include the value of LIMIT in the output because it is evenly 
divisible into itself. 


Learning How and When to Use a do...while Loop 


With all the loops you have written so far, the loop body might execute many times, but it is 
also possible that the loop will not execute at all. For example, recall the bank balance 
program that displays compound interest, which was shown in Figure 6-8. The program 
begins by asking whether the user wants to see next year’s balance. If the user doesn’t enter a 
1 for yes, the loop body never executes. 
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Similarly, recall the EnterSma11Value application in Figure 6-10. The user is prompted to 
enter a value, and if the user enters a value that is 3 or less, the error-reporting loop body 
never executes. 


In each of these cases, the loop control variable is evaluated at the “top” of the loop before the 
body has a chance to execute. Both while loops and for loops are pretest loops—ones in 


see which the loop control variable is tested before the loop body executes. 





Sometimes, you might need to ensure that a loop body executes at least one time. If so, 
you want to write a loop that checks at the “bottom” of the loop after the first iteration. 
The do..while loop is such a loop; it is a posttest loop—one in which the loop control variable 
is tested after the loop body executes. 


Figure 6-20 shows the general structure of a do..while loop. Notice that the loop body 
executes before the loop-controlling question is asked even one time. Figure 6-21 shows 
a BankBalance2 application that contains a do..while loop. The loop starts with the 
shaded keyword do. The body of the loop follows and is contained within curly braces. 
The first year’s balance is output before the user has any option of responding. At the 
bottom of the loop, the user is prompted, “Do you want to see the balance at the end of 
another year?” Now the user has the option of seeing more balances, but viewing the 
first display was unavoidable. The user’s response is checked in the shaded evaluation at 
the bottom of the loop; if it is 2 for yes, the loop repeats. Figure 6-22 shows a typical 
execution. 










loop body 





test of loop 
control variable 





Figure 6-20 General structure of a do...whi1e loop 
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import java.util.Scanner; 
public class BankBalance2 








{ 
public static void main(String[] args) 
{ 323 
double balance; 
int response; 
int year = 1; 
final double INT_RATE = 0.03; 
Scanner keyboard = new Scanner(System.in); 
System.out.printC"Enter initial bank balance > "); 
balance = keyboard.nextDoubleQ); 
keyboard.nextLineQ ; 
do 
{ 
balance = balance + balance * INT_RATE; 
System.out.printInC"After year " + year + " at " + INT_RATE + 
" interest rate, balance is $" + balance); 
year = year + 1; 
System.out.printIn("\nDo you want to see the balance " + 
"at the end of another year?"); 
System.out.printInC"Enter 1 for yes"); 
System.out.printC¢" or any other number for no >> "); 
response = keyboard.nextIntQ; 
} while(response == 1); 
} 
} 


Figure 6-21 A do..whi le loop for the BankBalancez2 application 





— 


* initial bank balance > 26086 
year 1 at @.03 interest rate. balance is $2060.06 





Do you want to see the balance at the end of another year? 
Enter 1 for yes 

or any other number for no >> 1 
After year 2 at @.03 interest rate. balance is $2121.8 


Do you want to see the balance at the end of another year? 
mEnter 1 for yes 
or any other number for no >> 2 


aE UT. B2 





Figure 6-22 Typical execution of the BankBalance2 program 
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When the body of a do..while loop contains a single statement, you do not need to use curly 
braces to block the statement. For example, the following loop correctly adds numberValue to 
total while total remains less than 200: 


do 
324 total += numberValue; 
while(total < 200); 





Even though curly braces are not required in this case, many programmers recommend using 
them. Doing so prevents the third line of code from looking like it should begin a new while 
loop instead of ending the previous do..while loop. Therefore, even though the result is the 
same, the following example that includes curly braces is less likely to be misunderstood by a 
reader: 


do 


{ 
total += numberValue; 
} whileC(total < 200); 


You are never required to use a do..while loop. Within the bank balance example, you could 
achieve the same results as the logic shown in Figure 6-21 by unconditionally displaying the 
first year’s bank balance once before starting the loop, prompting the user, and then starting a 
while loop that might not be entered. However, when you know you want to perform some 
task at least one time, the do..while loop is convenient. 


Learning How and When to Use a do..while Loop 


1. The do..while loop checks the value of the loop control variable at the top of the 
loop prior to loop execution. 


2. When the statements in a loop body must execute at least one time, it is 
convenient to use a do..while loop. 


3. When the body of a do..while loop contains a single statement, you do not need 
to use curly braces to block the statement. 
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Learning About Nested Loops 


Just as if statements can be nested, so can loops. You can place a while loop within a while 
loop, a for loop within a for loop, a while loop within a for loop, or any other combination. 
When loops are nested, each pair contains an inner loop and an outer loop. The inner loop 
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must be entirely contained within the outer loop; loops can never overlap. Figure 6-23 shows 
a diagram in which the shaded loop is nested within another loop; the shaded area is the inner 
loop. You can nest virtually any number of loops; however, at some point, your machine will 
no longer be able to store all the necessary looping information. 


325 








test of outer 
loop control 


body of 


loop control : 
inner loop 


variable 








Figure 6-23 Nested loops 


Suppose you want to display future bank balances while varying both years and interest rates. 
Figure 6-24 shows an application that contains an outer loop that varies interest rates 
between specified limits. At the start of the outer loop, the working balance is reset to its 
initial value so that calculations are correct for each revised interest rate value. The shaded 
inner loop varies the number of years and displays each calculated balance. Figure 6-25 shows 
a typical execution. 


import java.util.Scanner; 
public class BankBalanceByRateAndYear 
{ 
public static void main(String[] args) 
{ 
double initialBalance; 
double balance; 
int year; 
double interest; 
final double LOW = 0.02; 
final double HIGH = 0.05; 
final double INCREMENT = 0.01; 
final int MAX_YEAR = 4; 
Scanner keyboard = new Scanner(System.in); 
System.out.printC"Enter initial bank balance > "); 
initialBalance = keyboard.nextDoubleQ); 
keyboard.nextLineQ) ; 





Figure 6-24 The BankBalanceByRateAndYear class containing nested loops (continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





HAPTER 6 Looping 


(continued) 


forCinterest = LOW; interest <= HIGH; interest += INCREMENT) 
{ 
balance = initialBalance; 
326 System.out.printInC"\nwWith an initial balance of $" + 
balance + " at an interest rate of " + interest); 
for(year = 1; year <= MAX_YEAR; ++ year) 





{ 
balance = balance + balance * interest; 
System.out.printInC"After year " + year + 
" balance is $" + balance); 
} 





C:\Java>java BankBalanceByRatefAndYear 
Enter initial bank balance > 1666.06 


Mith an initial balance of $100@.@ at an interest 
year 1 balance is $1620.0 
year 2 balance is $1640.4 
year 3 balance is $1061.208 
year 4 balance is $1082.43216 


With an initial balance of $16006.6 at an interest 
year 1 balance $1030.8 
year 2 balance $1060.9 
year 3 balance $1692 .727 
year 4 balance is $1125.50881 


an initial balance of $1000.60 at an interest 
year 1 balance is $1040.0 
year 2 balance $1081 .6 
year 3 balance $1124.8639999999998 
year 4 balance is $1169.85856 


With an initial balance of $1000.@ at an interest 
year 1 balance is $1656.0 
year 2 balance $1162.5 
year 3 balance is $1157.625 
year 4 balance is $1215.58625 


C:\Java> 


























Figure 6-25 Typical execution of the BankBalanceByRateAndYear program 


In Figure 6-25, the floating-point calculations result in balances that contain fractions of pennies. If you wrote 
this program for a bank, you would have to ask whether interest should be compounded on fractions of a 
cent as it is here, or whether the amounts should be either rounded or truncated. 
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Learning About Nested Loops) 


When you nest loops, sometimes it doesn’t make any difference which variable controls the 
outer loop and which variable controls the inner one, but frequently it does make a difference. 
When you use a loop within a loop, you should always think of the outer loop as the all- 
encompassing loop. The variable in the outer loop changes more infrequently. For example, 
suppose a method named outputLabel() creates customer mailing labels in three different 
colors to use in successive promotional mailings. The following nested loop calls the method 
60 times and produces three labels for the first customer, three labels for the second 
customer, and so on: 


327 








for(customer = 1; customer <= 20; ++customer) 
for(color = 1; color <= 3; ++color) 
outputLabel () ; 


The following nested loop also calls outputLabel() 60 times, and it ultimately produces the 
same 60 labels, but it creates 20 labels in the first color, 20 labels in the second color, and then 
20 labels in the third color. 


for(color = 1; color <= 3; ++color) 
for(customer = 1; customer <= 20; ++customer) 
outputLabel (); 


If changing the ink color is a time-consuming process that occurs in the method, the second 
nested loop might execute much faster than the first one. 


ee 
—— Watch the video Nested Loops. 


Learning About Nested Loops 


1. You can place a while loop within a while loop or a for loop within a for loop, 
but you cannot mix loop types. 


An inner nested loop must be entirely contained within its outer loop. 
3. The body of the following loop executes 20 times: 


for(int x = 0; x < 4; 44x) 
for(int y = 0; y < 5; ++y) 
System.out.printIn("Hi") ; 
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x You Do It 


Working with Nested Loops 


Suppose you want to know not just what numbers go evenly into 100 but also what 
numbers go evenly into every positive number, up to and including 100. You can write 
99 more loops—one that shows the numbers that divide evenly into 1, another that 
shows the numbers that divide evenly into 2, and so on—or you can place the current 
loop inside a different, outer loop, as you do next. 


1. If necessary, open the file DivideEvenly.java in your text editor, 
change the class name to DivideEvenly2, and then save the class as 
DivideEvenly2. java. 


2. Add anew variable declaration at the beginning of the file with the other 
variable declarations: 


int number; 


3. Replace the existing for loop with the following nested loop. The outer loop 
varies number from 1 to 100. For each number in the outer loop, the inner 
loop uses each positive integer from 1 up to the number and tests whether it 
divides evenly into the number: 


for (number = 1; number <= LIMIT; ++number) 
{ 
System.out.print(number + " is evenly divisible by "); 
for(var = 1; var <= number; ++var) 
if (number % var == 0) 
System.out.print(var+""); 
// Display the number and a space 
System.out.printind); 
} 


4. Make certain the file ends with three curly braces—one for the for outer loop 
that varies number, one for the main© method, and one for the class. The 
inner loop does not need curly braces because it contains a single output 
statement, although you could add a set of braces for the loop. 


5. Save the file as DivideEvenly2.java, and then compile and execute 
the application. When the output stops scrolling, it should look similar to 
Figure 6-26. 
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Figure 6-26 Output of the DivideEvenly2 application when scrolling stops 


Improving Loop Performance 


Whether you decide to use a whi 1e, for, or do..whi1e loop in an application, you can improve 
loop performance by doing the following: 


e Making sure the loop does not include unnecessary operations or statements 
e Considering the order of evaluation for short-circuit operators 

e Making a comparison to 0 

e Employing loop fusion 


e Using prefix incrementing rather than postfix incrementing 


Avoiding Unnecessary Operations 


You can make loops more efficient by not using unnecessary operations or statements, either 
within a loop’s tested expression or within the loop body. For example, suppose a loop should 
execute while x is less than the sum of two integers, a and b. The loop could be written as: 
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CHAPTER 6 Looping 


while (x < a+b) 
// \oop body 









Don't Do It 
It might be inefficient to 
recalculate a + b 

for every loop iteration. 


330 If this loop executes 1,000 times, then the expression a + b is calculated 1,000 times. Instead, 
if you use the following code, the results are the same, but the arithmetic is performed only 
once: 





int sum =a+b; 
while(x < sum) 
// \oop body 


Of course, if a or b is altered in the loop body, then a new sum must be calculated with every 
loop iteration. However, if the sum of a and b is fixed prior to the start of the loop, then 
writing the code the second way is far more efficient. 


Similarly, try to avoid a method call within a loop if possible. For example, if the method 
getNumberOfEmployees() always returns the same value during a program’s execution, then 
a loop that begins as follows might unnecessarily call the method many times: 


whileCcount < getNumberOfEmp]oyees())... 


It is more efficient to call the method once, store the result in a variable, and use the variable 
in the repeated evaluations, as in this example: 


numEmployees = getNumberOfEmployees() ; 


whileCcount < numEmployees)... 


Considering the Order of Evaluation of Short-Circuit Operators 


In Chapter 5 you learned that the expressions in each part of an AND or an OR expression 
use short-circuit evaluation; that is, they are evaluated only as much as necessary to 
determine whether the entire expression is true or false. When a loop might execute 
many times, it becomes increasingly important to consider the number of evaluations 
that take place. 


For example, suppose a user can request any number of printed copies of a report from 0 to 
15, and you want to validate the user’s input before proceeding. If you believe that users are 
far more likely to enter a value that is too high than to enter a negative one, then you want to 
start a loop that reprompts the user with the following expression: 


whileCrequestedNum > LIMIT || requestedNum < 0)... 


Because you believe that the first Boolean expression is more likely to be true than the 
second one, you can eliminate testing the second one on more occasions. The order of 
the expressions is not very important in a single loop, but if this loop is nested within 
another loop, then the difference in the number of tests increases. Similarly, the order of 
the evaluations in if statements is more important when the if statements are nested 
within a loop. 
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Comparing to Zero 


Making a comparison to 0 is faster than making a comparison to any other value. Therefore, 

if your application makes comparison to 0 feasible, you can improve loop performance by 

structuring your loops to compare the loop control variable to 0 instead of some other value. For 
example, a loop that performs based on a variable that varies from 0 up to 100,000 executes the 331 
same number of times as a loop based on a variable that varies from 100,000 down to 0. However, 
the second loop performs slightly faster. Comparing a value to 0 instead of other values is faster 
because in a compiled language, condition flags for the comparison are set once, no matter how 
many times the loop executes. Comparing a value to 0 is faster than comparing to other values, no 
matter which comparison operator you use—greater than, less than, equal to, and so on. 








Figure 6-27 contains a program that tests the execution times of two nested do-nothing loops. 
(A do-nothing loop is one that performs no actions other than looping.) Before each loop, the 
System method currentTimeMillis() is called to retrieve the current time represented in 
milliseconds. After each nested loop repeats 100,000 times, the current time is retrieved 
again. Subtracting the two times computes the interval. As the execution in Figure 6-28 
shows, there is a small difference in execution time between the two loops—about 1/100 of a 
second. The amount of time will vary on different machines, but the loop that uses the 0 
comparison will never be slower than the other one. The difference would become more 
pronounced with additional repetitions or further nesting levels. If the loops used the loop 
control variable, for example, to display a count to the user, then they might need to 
increment the variable. However, if the purposes of the loops are just to count iterations, you 
might consider making the loop comparison use 0. 


public class CompareLoops 
{ 
public static void main(String[] args) 
{ 
long startTimel, startTime2, endTimel, endTime2; 
final int REPEAT = 100000; 
startTimel = System.currentTimeMillisQ); 
forCint x = 0; x <= REPEAT; ++x) 
forCint y = 0; y <= REPEAT; ++y); 
endTimel = System.currentTimeMillisQ; 


" 


System.out.printInC"Time for loops starting from 0: + 


CendTimel - startTimel) + milliseconds"); 
startTime2 = System.currentTimeMillisQ); 
for(int x = REPEAT; x >= 0; --x) 
for(int y = REPEAT; y >= 0; --y); 
endTime2 = System.currentTimeMillisQ; 
System.out.printInC"Time for loops ending at 0: " + 
CendTime2 - startTime2) + " milliseconds"); 





Figure 6-27 The CompareLoops application 
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| CRMEUrD ALU Compare Loops 
Time for loops starting from @: 7197 milliseconds 
Time for loops ending at @: 7143 milliseconds 


332 C:\Java> 




















Figure 6-28 Typical execution of the CompareLoops application 


If you execute the program in Figure 6-27, you probably will see different results. With a fast operating 
system, you might not see the differences shown in Figure 6-28. If so, experiment with the program by 
increasing the value of REPEAT or by adding more nested levels to the loops. 





Employing Loop Fusion 


Loop fusion is the technique of combining two loops into one. For example, suppose you want 
to call two methods 100 times each. You can set a constant named TIMES to 100 and use the 
following code: 


for(int x = 0; x < TIMES; ++x) 
method1Q); 

for(int x = 0; x < TIMES; ++x) 
method2(); 


However, you can also use the following code: 


for(int x = 0; x < TIMES; ++x) 
{ 

method1Q); 

method2(); 
} 


Fusing loops will not work in every situation; sometimes all the activities for method1() must 
be finished before those in method2() can begin. However, if the two methods do not depend 
on each other, fusing the loops can improve performance. On the other hand, if saving a few 
milliseconds ends up making your code harder to understand, you almost always should err in 
favor of slower but more readable programs. 


Using Prefix Incrementing Rather than Postfix Incrementing 


Probably the most common action after the second semicolon in a for statement is to 
increment the loop control variable. In most textbooks and in many professional programs, 
the postfix increment operator is used for this purpose, as in the following: 


for(int x = 0; x < LIMIT; x++) 
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Because incrementing x is a stand-alone statement in the for loop, the result is identical 
whether you use x++ or ++x. However, using the prefix increment operator produces a faster 
loop. Consider the program in Figure 6-29. It is similar to the CompareLoops application in 
Figure 6-27, but instead of comparing loops that count up and down, it compares loops that 
use prefix and postfix incrementing. The two timed, bodyless loops that repeat 1 billion times 
each are shaded in the figure. 333 








public class CompareLoops2 
{ 
public static void main(String[] args) 
{ 
long startTimel, startTime2, endTimel, endTime2; 
final long REPEAT = 1000000000L; 
startTimel = System.currentTimeMillisQ; 
for(int x = 0; x < REPEAT; x++); 
endTimel = System.currentTimeMillisQ; 


System.out.printInC"Time with postfix increment: + 


CendTimel - startTimel)+ milliseconds"); 
startTime2 = System.currentTimeMillis(); 
forCint x = 0; x < REPEAT; ++x); 
endTime2 = System.currentTimeMillisQ; 
System.out.printInC"Time with prefix increment: " + 
CendTime2 - startTime2)+ " milliseconds"); 





Figure 6-29 The CompareLoops2 program 


Figure 6-30 shows the output of the program. The program that uses prefix incrementing 
runs slightly faster than the one that uses postfix incrementing because when the compiler 
uses postfix incrementing, it first makes a copy of the variable it uses as the expression’s value, 
and then it increments the variable. In other words, the operators are methods that behave as 
follows: 


e When you use the prefix incrementing method, as in ++x, the method receives a reference 
to x, increases it, and returns the increased value. 


e When you use the postfix incrementing method, as in x++, the method receives a 
reference to x, makes a copy of the value and stores it, increments the value indicated by 
the reference, and returns the copy. The extra time required to make the copy is what 
causes postfix incrementing to take longer. 


As you can see in Figure 6-30, the difference in duration for the loops is very small. If you run 
the program multiple times, you will get different results, and sometimes the prefix operator 
loop will take longer because other programs are running concurrently on your computer. 

However, using the prefix operator typically saves a small amount of time. As a professional, 
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you will encounter programmers who insist on using either postfix or prefix increments in 
their loops. You should follow the conventions established by your organization, but now you 
have the tools to prove that prefix incrementing is faster. 


334 








\ 7 
werner 


C:\Java>java CompareLoops2 
Time with postfix increment: 2294 milliseconds 
Time with prefix increment: 2183 milliseconds 





C:\Java> 











Figure 6-30 Typical execution of the CompareLoops2 application 


In the previous sections, you have learned to improve loop performance by eliminating 
unnecessary operations, considering the order of evaluation for short-circuit operators, 
making comparisons to 0, employing loop fusion, and using prefix incrementing rather than 
postfix incrementing. As you become an experienced programmer, you will discover other 
ways to enhance the operation of the programs you write. You should always be on the 
lookout for ways to improve program performance. 


Improving Loop Performance 


1. You can improve the performance of a loop by making sure the loop does not 
include unnecessary operations in the tested expression. 


2. You can improve loop performance by making sure the loop does not include 
unnecessary operations in the body of the loop. 


3. You can improve loop performance when two conditions must both be true by 
testing for the most likely occurrence first. 
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Comparing Execution Times for Separate and Fused Loops 
335 








In this section, you compare the execution times for accomplishing the same tasks 
using two loops or a single one. 


1. Open a new file in your text editor, and start a class named TimeFusedLoop. 


public class TimeFusedLoop 


{ 
public static void main(String[] args) 


{ 


2. Create variables to hold starting and ending times for two operations, and 
create a constant that holds a number of times to repeat loops: 


long startTimel, startTime2, endTimel, endTime2; 
final int REPEAT = 10000; 


3. Geta starting time. Then, in a loop that repeats 10,000 times, call a method 
named method1(), which accepts a parameter that controls loop repetitions 
within the method. When the iterations are complete, call a similar method, 
method2(), 10,000 times. 


startTimel = System. currentTimeMillisQ) ; 
forCint x = REPEAT; x >= 0; --x) 

method1 (REPEAT) ; 
forCint x = REPEAT; x >= 0; --x) 

method2 (REPEAT) ; 


4. Get the ending time, and display the difference between the starting and 
ending times. 


endTimel = System.currentTimeMillisQ; 
System.out.printInC"Time for two separate loops: " + 
CendTimel - startTimel)+ " milliseconds"); 


5. Get a new starting time, and call method1() and method2() 10,000 times 
each in a single loop. Then get the ending time, and display the difference. 
Add a closing curly brace for the main® method. 


startTime2 = System.currentTimeMillisQ) ; 
forCint x = REPEAT; x >= 0; --x) 
{ 
method1 (REPEAT) ; 
method2 (REPEAT) ; 
} 
endTime2 = System.currentTimeMillisQ; 
System.out.printInC"Time for fused loops: " + 
CendTime2 - startTime2)+ " milliseconds"); 


: (continues) 
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(continued) 


6. Create the two methods named method1() and method2(). Each simply 
executes a do-nothing loop the number of times indicated by its parameter. 





336 Add a closing curly brace for the class. 
public static void method1l(final int REPEAT) 
: forCint x = REPEAT; x >= 0; --x); 
ere static void method2(final int REPEAT) 
forCint x = REPEAT; x >= 0; --x); 


} 


7. Save the file as TimeFusedLoop.java, and then compile and execute it. Figure 
6-31 shows the execution. The times might differ on your system, but you should 
be able to see that using a single loop significantly improves performance over 
using separate loops. If your system is very fast, you might have to increase the 
value of the REPEAT constant (perhaps changing it from an int to a long), or 
change the body of each method to contain a nested loop such as the following: 


forCint x = REPEAT; x >= 0; --x); 
for(int y = REPEAT; y >= 0; --y); 





r 


fay Command Prompt 


- 
C:\Java>java TimeFusedLoop 

Time for two separate loops: 196 milliseconds 
Time for fused loops: 15? milliseconds 


C:\Java> 














Figure 6-31 Execution of the TimeFusedLoop program 


8. Experiment with increasing and decreasing the value of REPEAT, and observe the 
effects. The time values you observe might also differ when you run the program 
at different times, depending on what other tasks are running on your system 
concurrently. 
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Don't Do It 


e Don't insert a semicolon at the end of a while clause before the loop body; doing so 
creates an empty loop body. 


e Don't forget to block multiple statements that should execute in a loop. 
337 








e Don't make the mistake of checking for invalid data using a decision instead of a loop. 
Users might enter incorrect data multiple times, so a loop is the superior choice for input 
validation. 


e Don't ignore subtleties in the boundaries used to stop loop performance. For example, 
looping while interest rates are less than 8% is different than looping while interest rates 
are no more than 8%. 


e Don't repeat steps within a loop that could just as well be placed outside the loop; your 
program performance will improve. 





Key Terms 


A loop is a structure that allows repeated execution of a block of statements. 


A loop body is the block of statements that executes when the Boolean expression that 
controls the loop is true. 


An iteration is one loop execution. 


Awhile loop executes a body of statements continually as long as the Boolean expression that 
controls entry into the loop continues to be true. 


A loop that executes a specific number of times is a definite loop or a counted loop. 
An indefinite loop is one in which the final number of loops is unknown. 


A loop control variable is a variable whose value determines whether loop execution 
continues. 








An infinite loop is a loop that never ends. 

An empty body is a block with no statements in it. 
A counter-controlled loop is a definite loop. 
Incrementing a variable adds 1 to its value. 
Decrementing a variable reduces its value by 1. 


An indefinite loop is an event-controlled loop. 
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Validating data is the process of ensuring that a value falls within a specified range. 


A priming read or priming input is the first input statement prior to a loop that will execute 
subsequent input statements for the same variable. 


Counting is the process of continually incrementing a variable to keep track of the number of 
338 occurrences of some event. 





Accumulating is the process of repeatedly increasing a value by some amount to produce a 
total. 


The add and assign operator ( += ) alters the value of the operand on the left by adding the 
operand on the right to it. 


The subtract and assign operator ( —= ) alters the value of the operand on the left by 
subtracting the operand on the right from it. 


The multiply and assign operator ( *= ) alters the value of the operand on the left by 
multiplying the operand on the right by it. 


The divide and assign operator ( /= ) alters the value of the operand on the left by dividing the 
operand on the right into it. 


The remainder and assign operator ( %= ) alters the value of the operand on the left by 
assigning the remainder when the left operand is divided by the right operand. 


The prefix ++, also known as the prefix increment operator, adds 1 to a variable, then 
evaluates it. 


The postfix ++, also known as the postfix increment operator, evaluates a variable, then 
adds 1 to it. 


The prefix and postfix decrement operators subtract 1 from a variable. 


A for loop is a special loop that can be used when a definite number of loop iterations is 
required. 


A pretest loop is one in which the loop control variable is tested before the loop body 
executes. 


The do..while loop executes a loop body at least one time; it checks the loop control variable 
at the bottom of the loop after one repetition has occurred. 









A posttest loop is one in which the loop control variable is tested after the loop body executes. 
An inner loop is contained entirely within another loop. 

An outer loop contains another loop. 

A do-nothing loop is one that performs no actions other than looping. 


Loop fusion is the technique of combining two loops into one. 
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Chapter Summary 


e A loop is a structure that allows repeated execution of a block of statements. Within a 
looping structure, a Boolean expression is evaluated, and if it is true, a block of statements 


called the loop body executes; then the Boolean expression is evaluated again. 
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e You can use a while loop to execute a body of statements continually while some 
condition continues to be true. To execute a while loop, you initialize a loop control 
variable, test it in a while statement, and then alter the loop control variable in the body of 
the while structure. 


e The add and assign operator ( += ) adds and assigns in one operation. Similar versions are 
available for subtraction, multiplication, and division. The prefix and postfix increment 
operators increase a variable’s value by 1. The prefix and postfix decrement operators 
reduce a variable’s value by 1. An expression that uses a prefix operator uses the altered 
value, but an expression that uses a postfix operator uses the initial value before the 
increase. 


e A for loop initializes, tests, and increments in one statement. There are three sections 
within the parentheses of a for loop that are separated by exactly two semicolons. 


e The do..while loop tests a Boolean expression after one repetition has taken place, at the 
bottom of the loop. 


e Loops can be nested, creating inner and outer loops. 


e You can improve loop performance by making sure the loop does not include unnecessary 
operations or statements and by considering factors such as short-circuit evaluation, zero 
comparisons, loop fusion, and prefix incrementing. 


Review Questions 


1. A structure that allows repeated execution of a block of statements is 











a 
a. cycle c. ring 
b. loop d. band 

2. A loop that never ends is a(n) _______ loop. 
a. iterative c. structured 
b. infinite d. illegal 


3. To construct a loop that works correctly, you should initialize a loop 
control 


a. variable c. structure 


b. constant d. condition 
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10. 


What is the output of the following code? 


b= 1; 
while(b < 4) 
System.out.print(b +" "); 
a eG 1234 


b. 123 d. 111111... 


What is the output of the following code? 


b= 1; 
while(b < 4) 
{ 
System.out.print(b + " "); 
b=b+1; 
} 
ae c 1234 
pe age d& 114 Li, 


What is the output of the following code? 


e=1; 
while(e < 4); 
System.out.print(e +" "); 


a. Nothing c. 1234 
b. 111111... d. 444444... 


If total = 100 and amt = 200, then after the statement total += 


amt, 

a. total is equal to 200 c. amt is equal to 100 
b. total is equal to 300 d. amt is equal to 300 
The prefix ++ is a ___________ operator. 

a. unary c. tertiary 

b. binary d. postfix 


If g = 5, then after h = ++g, the value of h is 


c. 6 
5 d. 7 


~ 
aN 


Ifm = 9, then after n = m++, the value of m is 


a. 8 c. 10 
b. 9 d. il 
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Review Questions iii 


11. Ifm = 9, then after n = m+4, the value of n is 








a 8 c. 10 
b. 9 11 
12. Ifj = 5andk = 6, then the value of j++ == k is 341 
a 5 c. true 
b. 6 d. false 
13. You must always include __________ in a for loop’s parentheses. 


two semicolons 
three semicolons 


two commas 


ao Ff PS 


three commas 


14. What does the following statement output? 


for(a = 0; a < 5; ++a) 
System.out.print(a + " "); 


a. 00000 c. 012345 
b. 01234 d. nothing 


15. What does the following statement output? 


for(b = 1; b > 3; 4++b) 
System.out.print(b + " "); 


a 1l1il c 1234 

b. 123 d. nothing 
16. What does the following statement output? 

for(f = 1, g = 4; f < g; ++f, --g) 










System.out.print(f + ""+g+" "); 
a 14253647... c 1423 
b. 142332 d. nothing 


17. The loop that performs its conditional check at the bottom of the loop is a 
loop. 


a. while c. for 
b. do..while d. for..while 
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18. What does the following program segment output? 
d = 0; 
do 
{ 
System.out.print(d + " "); 
d++; 
} while (d < 2); 
a. O c. O12 
b. O1 d. nothing 
19. What does the following program segment output? 
for(f = 0; f < 3; +f) 
for(g = 0; g < 2; ++g) 
System.out.print(f +" "+g+" "); 
a 000110112021 ec 01021112 
b. 010203111213 d 000102101112202122 
20. What does the following program segment output? 
for(m = 0; m < 4; +4+m); 
for(n = 0; n < 2; ++n); 
System.out.printtm +" "4n4" "); 
a 0001101120213031 c 42 
b. 010211122122 d. 31 
Exercises 
=) Programming Exercises 
1. 


a. Write an application that counts by five from 5 through 200 inclusive, and that 


starts a new line after every multiple of 50 (50, 100, 150, and 200). Save the file as 
CountByFives.java. 


. Modify the CountByFives application so that the user enters the value to count 


by. Start each new line after 10 values have been displayed. Save the file as 
CountByAnything.java. 


Write an application that asks a user to type an even number to continue or to type 
999 to stop. When the user types an even number, display the message “Good job!” 
and then ask for another input. When the user types an odd number, display an error 
message and then ask for another input. When the user types 999, end the program. 
Save the file as EvenEntryLoop.java. 
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3. Write an application that displays the factorial for every integer value from 1 to 10. A 
factorial of a number is the product of that number multiplied by each positive integer 
lower than it. For example, 4 factorial is 4* 3 * 2* 1, or 24. Save the file as Factorials.java. 


4, Write an application that prompts a user for two integers and displays every integer 
between them. Display a message if there are no integers between the entered values. 343 
Make sure the program works regardless of which entered value is larger. Save the file 
as InBetween.java. 








5. A knot isa unit of speed equal to one nautical mile per hour. Write an application that 
displays every integer knot value from 15 through 30 and its kilometers per hour and 
miles per hour equivalents. One nautical mile is 1.852 kilometers or 1.151 miles. Save 
the file as Knots.java. 


6. Write an application that shows the sum of 1 to n for every from 1 to 50. That is, the 
program displays 1 (the sum of 1 alone), 3 (the sum of 1 and 2), 6 (the sum of 1, 2, 
and 3), 10 (the sum of 1, 2, 3, and 4), and so on. Save the file as EverySum.java. 


7. Write an application that displays every perfect number from 1 through 1,000. A 
perfect number is one that equals the sum of all the numbers that divide evenly into it. 
For example, 6 is perfect because 1, 2, and 3 divide evenly into it, and their sum is 6; 
however, 12 is not a perfect number because 1, 2, 3, 4, and 6 divide evenly into it, and 
their sum is greater than 12. Save the file as Perfect.java. 


8. Write an application that uses a loop to create the pattern of Xs shown in Figure 6-32, 
in which each X is displayed one additional space to the right. Save the file as 
Diagonal. java. 





rm 





fH Command Prompt =" For 


C:\Java>java Diagonal 










Figure 6-32 Output of the Diagonal application 


9. Write an application that prompts a user for a child’s current age and the estimated 
college costs for that child at age 18. Continue to reprompt a user who enters an age 
value greater than 18. Display the amount that the user needs to save each year until 
the child turns 18, assuming that no interest is earned on the money. For this 
application, you can assume that integer division provides a sufficient answer. Save 
the file as CollegeCost.java. 
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10. 


Ls 


12: 


13. 


a. Write an application that prompts a user for the number of years the user 
has until retirement and the amount of money the user can save annually. 
If the user enters 0 or a negative number for either value, reprompt the user 
until valid entries are made. Assume that no interest is earned on the money. 
Display the amount of money the user will have at retirement. Save the file as 
RetirementGoal.java. 


b. Modify the RetirementGoal application to display the amount of money the user 
will have if the user earns 5% interest on the balance every year. Save the file as 
RetirementGoal2.java. 


Pickering Manufacturing Company randomly selects one of its four factories to inspect 
each week. Write an application that determines which factory will be selected each 
week for the next 52 weeks. Use the Math. random() function explained in Appendix D 
to generate a factory number between 1 and 4; you use a statement similar to: 


factory = 1+ Cint) (Math.random(Q) * 4); 


After each selection, display the factory to inspect, and after the 52 selections are 
complete, display the percentage of inspections at each factory for the year. Run the 
application several times until you are confident that the factory selection is random. 
Save the file as Inspections.java. 


Assume that the population of Mexico is 114 million and that the population 
increases 1.01 percent annually. Assume that the population of the United States is 
312 million and that the population is reduced 0.15 percent annually. Write an 
application that displays the populations for the two countries every year until the 
population of Mexico exceeds that of the United States, and display the number of 
years it took. Save the file as Population.java. 


Friendly Hal’s Used Cars has four salespeople named Pam, Leo, Kim, and Bob. Accept 
values for the number of cars sold by each salesperson in a month, and create a bar chart 
that illustrates sales, similar to the one in Figure 6-33. Save the file as BarGraph.java. 


= 
[x8 Command Prompt So 





Cc: \Java>java BarGraph 
"ca sold by Pam 
* ca ld by Leo 
* ca ld by Kim 
"ca sold by Bob 


Car Sales for Month 


RRARRRARR 
RRRRRARRAARRARARR 
RRRRRARARARA 
RARRRRR 








Figure 6-33 Typical execution of the BarGraph application 


Copyright 2013 Cengage Learning. All Rights Reserved. May notbe copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s) Editorial review has 


ight to remove additional content at any time if subsequent rights restrictions require it. 





14. a, Create a class named Purchase. Each Purchase contains an invoice number, 
amount of sale, and amount of sales tax. Include set methods for the invoice 
number and sale amount. Within the set( method for the sale amount, calculate 
the sales tax as 5% of the sale amount. Also include a display method that displays 


a purchase’s details. Save the file as Purchase.java. aac 








b. Create an application that declares a Purchase object and prompts the user 
for purchase details. When you prompt for an invoice number, do not let the 
user proceed until a number between 1,000 and 8,000 has been entered. 
When you prompt for a sale amount, do not proceed until the user has entered 
a nonnegative value. After a valid Purchase object has been created, display 
the object’s invoice number, sale amount, and sales tax. Save the file as 
CreatePurchase.java. 


15. Create a BabysittingJob class for Georgette’s Babysitting Service. The class contains 
fields to hold the following: 


e A job number that contains six digits. The first two digits represent the year, and 
the last four digits represent a sequential number. For example, the first job in 
2014 has a job number of 140001. 


e <Acode representing the employee assigned to the job. Assume that the code will 
always be 1, 2, or 3. 


e A name based on the babysitter code. Georgette has three babysitters: (1) Cindy, 
(2) Greg, and (3) Marcia. 


e The number of children to be watched. Assume that this number is always greater 
than zero. 


e The number of hours in the job. Assume that all hour values are whole numbers. 


e The fee for the job. Cindy is paid $7 per hour per child. Greg and Marcia are paid 
$9 an hour for the first child, and $4 per additional hour for each additional child. 
For example, if Greg watches three children for two hours, he makes $17 per hour 
for two hours, or $34. 


Create a constructor for the BabysittingJob class that accepts arguments for the job 
number, babysitter code, number of children, and hours. The constructor determines 
the babysitter name and fee for the job. Also include a method that displays every 
BabysittingJob object field. Save the file as BabysittingJob.java. 












Next, create an application that prompts the user for data for a babysitting job. Keep 
prompting the user for each of the following values until they are valid: 


e A four-digit year between 2013 and 2025 inclusive 
e A job number for the year between 1 and 9999 inclusive 


e A babysitter code of 1, 2, or 3 
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e A number of children for the job between 1 and 9 inclusive 


e A number of hours between 1 and 12 inclusive 


When all the data entries are valid, construct a job number from the last two digits 

of the year and a four-digit sequential number (which might require leading zeroes). 

346 Then, construct a BabysittingJob object, and display its values. Save the file as 
CreateBabysittingJob.java. 





ee Debugging Exercises 


1. Each of the following files in the Chapter06 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and fix the 
program. After you correct the errors, save each file using the same filename 
preceded with Fix. For example, save DebugSix1 java as FixDebugSix] java. 


a. DebugSixl java 
b. DebugSix2.java 
c. DebugSix3.java 
d. DebugSix4.java 


oO, Game Zone 


1. a. Write an application that creates a quiz. The quiz should contain at least five 
questions about a hobby, popular music, astronomy, or any other personal interest. 
Each question should be a multiple-choice question with at least four answer options. 
When the user answers the question correctly, display a congratulatory message. 
If the user responds to a question incorrectly, display an appropriate message as well 
as the correct answer. At the end of the quiz, display the number of correct and 
incorrect answers and the percentage of correct answers. Save the file as Quiz.java. 


b. Modify the Quiz application so that the user is presented with each question 
continually until it is answered correctly. Remove the calculation for percentage 
of correct answers—all users will have 100 percent correct by the time they 
complete the application. Save the file as Quiz2.java. 














2. In Chapter 1, you created a class called RandomGuess. In this game, players guess 
a number, the application generates a random number, and players determine 
whether they were correct. In Chapter 5, you improved the application to display 
a message indicating whether the player’s guess was correct, too high, or too low. 
Now, add a loop that continuously prompts the user for the number, indicating 
whether the guess is high or low, until the user enters the correct value. After the user 
correctly guesses the number, display a count of the number of attempts it took. Save 
the file as RandomGuess3.java. 
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3. In Chapter 4, you created a Die class from which you could instantiate an object 
containing a random value from 1 through 6. Now use the class to create a simple 
dice game in which the user chooses a number between 2 (the lowest total possible 
from two dice) and 12 (the highest total possible). The user “rolls” two dice up to 
three times. If the number chosen by the user comes up, the user wins and the game 
ends. If the number does not come up within three rolls, the computer wins. Save the 347 
application as TwoDice3.java. 








4, a. Using the Die class you created in Chapter 4, create a version of the dice game Pig 
that a user can play against the computer. The object of the game is to be the first 
to score 100 points. The user and computer take turns rolling a pair of dice 
following these rules: 


e Ona turn, each player “rolls” two dice. If no 1 appears, the dice values are 
added to a running total, and the player can choose whether to roll again or 
pass the turn to the other player. 


e Ifa appears on one of the dice, nothing more is added to the player’s total, 
and it becomes the other player’s turn. 


e Ifa appears on both of the dice, not only is the player’s turn over but the 
player’s entire accumulated score is reset to 0. 


e In this version of the game, when the computer does not roll a J and can 
choose whether to roll again, generate a random value between 0 and 1. 
Have the computer continue to roll the dice when the value is 0.5 or more, 
and have the computer quit and pass the turn to the player when the value 
is not 0.5 or more. 


Save the game as PigDiceGame.java. 


b. Modify the PigDiceGame application so that if a player rolls a J, not only does 
the player’s turn end but all the player’s earned points during that round are 
eliminated. (Points from earlier rounds are not affected. That is, when either the 
player or computer rolls a 1, all the points accumulated since the other had a turn 
are subtracted.) Save the game as PigDiceGame2.java. 


5. Two people play the game of Count 21 by taking turns entering a 1, 2, or 3, which is 
added to a running total. The player who adds the value that makes the total exceed 
21 loses the game. Create a game of Count 21 in which a player competes against the 
computer, and program a strategy that always allows the computer to win. On any 
turn, if the player enters a value other than 1, 2, or 3, force the player to reenter the 
value. Save the game as Count21.java. 
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Q Case Problems 


Carly’s Catering provides meals for parties and special events. In previous chapters, 
you developed a class that holds catering event information and an application that 
tests the methods using four objects of the class. Now modify the EventDemo class 
to do the following: 


348 





e Continuously prompt for the number of guests for each Event until the value 
falls between 5 and 100 inclusive. 


e For one of the Event objects, create a loop that displays “Please come to my 
event!” as many times as there are guests for the Event. 


Save the modified file as EventDemo.java. 


2. Sammy’s Seashore Supplies rents beach equipment to tourists. In previous 
chapters, you developed a class that holds equipment rental information and an 
application that tests the methods using four objects of the class. Now modify the 
RentalDemo class to do the following: 


e Continuously prompt for the number of minutes of each Rental until the value 
falls between 60 and 7,200 inclusive. 


e For one of the Rental objects, create a loop that displays “Coupon good for 10 
percent off next rental” as many times as there are full hours in the Rental. 


Save the modified file as RentalDemo.java. 
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Characters, Strings, 
and the 
StringBuilder 


In this chapter, you will: 


Identify string data problems 


(©) 


Manipulate characters 


ORO) 


Declare and compare String objects 
Use other String methods 


(ORO) 


Convert String objects to numbers 


Use the StringBuilder and StringBuffer classes 


(©) 
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CHAPTER 7 Characters, Strings, and the StringBuilder 


Understanding String Data Problems 


Manipulating characters and strings provides some challenges for the beginning Java 

programmer. For example, consider the TryToCompareStrings application shown in 

Figure 7-1. The main() method declares a String named aName and assigns “Carmen” to it. 
350 The user is then prompted to enter a name. The application compares the two names using 
the equivalency operator ( == ) and displays one of two messages indicating whether the 
strings are equivalent. 





import java.util.Scanner; 
public class TryToCompareStrings 
{ 


| 
| 
public static void main(String[] args) 






{ 
String aName = "Carmen"; Don't Do It 
String anotherName; Do not use == to 
Scanner input = new Scanner(System. in); compare Strings’ 
System.out.printC"Enter your name > "); contents. 
anotherName = input.nextLineQ) ; 
ifCaName == anotherName) 
System.out.printIn(aName + " equals " + anotherName) ; 
else 
System.out.println(aName + " does not equal " + anotherName) ; | 
3 


} | 


Figure 7-1 The TryToCompareStrings application 


Figure 7-2 shows the execution of the application. When the user types “Carmen” as the value 
for anotherName, the application concludes that the two names are not equal. 





G 
GH Command Prompt cane 
i 





C:\Java>java TryToCompareStrings 
Enter your name > Carmen 
Carmen does not equal Carmen 


C:\Java> 





Figure 7-2 Execution of the TryToCompareStrings application 


The application in Figure 7-1 seems to produce incorrect results. The problem stems from 
the fact that in Java, String is a class, and each created String is an object. As an object, a 
String variable name is not a simple data type—it is a reference; that is, a variable that holds 
a memory address. Therefore, when you compare two String objects using the == operator, 
you are comparing not their values but their computer memory locations. 
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Programmers want to compare the contents of memory locations (the values stored there) 
more frequently than they want to compare the locations themselves (the addresses). 
Fortunately, the creators of Java have provided three classes that you can use when working 
with text data; these classes provide you with many methods that make working with 


characters and strings easier: 
351 








e Character—A class whose instances can hold a single character value and whose 
methods manipulate and inspect single-character data 


e String—A class for working with fixed-string data—that is, unchanging data composed 
of multiple characters 


e StringBuilder and StringBuffer—Classes for storing and manipulating changeable data 
composed of multiple characters 


Understanding String Data Problems 


1. A String is a simple data type that can hold text data. 


2. Programmers want to compare the values of Strings more frequently than they 
want to compare their memory addresses. 


3. Character, String, and StringBuilder are useful builtin classes for working 
with text data. 


“ssauppe AJOWawW e 
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Manipulating Characters 


You learned in Chapter 2 that the char data type is used to hold any single character—for 
example, a letter, digit, or punctuation mark. In addition to the primitive data type char, Java 
offers a Character class. The Character class contains standard methods for testing the 
values of characters. Table 7-1 describes many of the Character class methods. The methods 
that begin with “is”, such as isUpperCase(), return a Boolean value that can be used in 
comparison statements; the methods that begin with “to”, such as toUpperCase(), return a 
character that has been converted to the stated format. 
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Method Description 

isUpperCaseQ) Tests if character is uppercase 

toUpperCase() Returns the uppercase equivalent of the argument; no change is made if 
352 the argument is not a lowercase letter 

jisLowerCase() Tests if character is lowercase 

toLowerCase() Returns the lowercase equivalent of the argument; no change is made if 

the argument is not an uppercase letter 

isDigitO Returns true if the argument is a digit (0-9) and false otherwise 

jisLetterQ Returns true if the argument is a letter and false otherwise 

isLetterOrDigitQ Returns true if the argument is a letter or digit and false otherwise 

isWhitespace() Returns true if the argument is whitespace and false otherwise; this 


includes the space, tab, newline, carriage return, and form feed 


1&)9 (75 Commonly used methods of the Character class 


write. The Character class inherits from java.lang.Object. You will learn more about the Object 


The Character class is defined in java. ]ang and is automatically imported into every program you 
Y class when you study inheritance concepts in the chapter Introduction to Inheritance. 


Figure 7-3 contains an application that uses many of the methods shown in Table 7-1. The 
application asks a user to enter a character. A String is accepted and the charAtQ method 
is used to extract the first character in the user-entered String. (The charAt() method belongs 
to the String class; you will learn more about this class and method later in this chapter.) The 
application determines the attributes of the character and displays information about it. 


import java.util.Scanner; 

public class TestCharacter 

{ 
public static void main(String[] args) 
{ 


char aChar; 


String aString; 

Scanner keyboard = new Scanner(System.in); 
System.out.printC"Enter a character... "); 

aString = keyboard.nextLine() ; 

aChar = aString.charAt(0) ; 
System.out.printInC"The character is " + aChar); 





Figure 7-3 The TestCharacter application (continues) 
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(continued) 


if(Character.isUpperCase(aChar)) 

System.out.printIn(aChar + " 
else 

System.out.printIn(aChar + 
if(Character.isLowerCase(aChar)) 

System.out.printIn(aChar + " 
else 

System.out.printIn(aChar + is not lowercase"); 
aChar = Character.toLowerCase(aChar) ; 
System.out.printInC"After toLowerCase(), aChar is 
aChar = Character.toUpperCase(aChar) ; 


iS uppercase"); 


is not uppercase"); 353 








is lowercase"); 


+ aChar); 


System.out.printInC"After toUpperCase(), aChar is 
if (Character.isLetterOrDigit(aChar)) 


+ aChar); 
System.out.printIn(aChar + " 
else 

System.out.printIn(aChar + 

"js neither a letter nor a digit"); 

if(Character.iswWhitespace(aChar)) 

System.out.printIn(aChar + " is whitespace") ; 
else 

System.out.printIn(aChar + 


is a letter or digit"); 


is not whitespace"); 





Figure 7-3 The TestCharacter application 


Figure 7-3 is a static method because the method name is used without an object reference—you use only 
the class name, a dot, and the method name. You learned about the difference between static and instance 
methods in Chapter 3. 


Q You can tell that each of the Character class methods used in the TestCharacter application in 


The output of three typical executions of the TestCharacter application is shown in 
Figure 7-4. For example, notice that when the character C is tested, you can see the 
following: 


e The value returned by the isUpperCase() method is true. 

e The value returned by the isLowerCase() method is false. 

e The value returned by the toLowerCase() method is ‘c’. 

e The value returned by the toUpperCase() method is ‘C’. 

e The value returned by the isLetterOrDigit(Q method is true. 


e The value returned by the iswhitespace() method is false. 
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a 
fy Command Prompt 





Java>java Te 
a char 

characte 
upperc 
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Java>java TestCharacter 
* a characte 

> character is ¢ 

is not uppercase 
lowercase 
* toLowerCa >, aChar 
* toUpper , aChar 
a letter or digit 

> not whitespace 


a chara 
haracte 


toLowerCas , aChar 
toUppe 5 , aChar 
a lette i 

s not whit 


C=\Java> 





Figure 7-4 Three typical executions of the TestCharacter application 


Manipulating Characters 


l. Character is a Class, but char is a simple data type. 


2. The Character class method isLowerCase() returns the lowercase version of 
any uppercase character. 


3. Ifa char variable holds the Unicode value for the Tab key, iswhitespace() 
would be true and isLetterOrDigit( would be false. 


‘Xd SL AY} BSN SAWEU BSOYM SPOUEW SSEII veqDeseYD aU} ||e OP Se ‘as_e4 JO 
anu SUINAI ()asedsaMo7s L POUJAW SSe|D vaqDe4eYD OU] ‘ZH SI JUaWWAle}S asjel OU] 
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Retrieving and Testing a Character 
355 








In this section, you write a short program that extracts a character from a String and 
uses Its lowercase equivalent. 


1. Open a new file in your text editor, and start a program that accepts a 
response from a user using an input dialog box. 


import javax. swing. JOptionPane; 
public class YLoop 
{ 


public static void main(String[] args) 


{ 


2. Declare a constant character that holds the value that indicates a user wants 
to continue. Also include the String the user enters, a variable to hold the 
contents of the first character in that String, and a count of the number of 
iterations performed. 


final char YES_OPTION = 'y'; 
String entryString; 

char entryChar; 

int count = 0; 


3. Accept a String response from the user, and use the charAt( method to 
extract the first character in the String. 


entryString = JOptionPane. showInputDialog(null, 
"Do you want to see a greeting?"); 
entryChar = entryString.charAt(0) ; 


4. Write a loop that is controlled by comparing the lowercase equivalent of the 
entry String’s first character to 'y'. Within the loop, count is incremented 
and then displayed along with a greeting and a prompt that asks the user 
whether an additional greeting should be displayed. The first character is 
extracted from the new String the user enters. 


while(Character.toLowerCase(entryChar) == YES_OPTION) 
{ 
++count; 
entryString = JOptionPane. showInputDialog(null, 
"Greeting #" + count + 
"Hello! \nDo you want to see another greeting?" ) ; 
entryChar = entryString.charAt(0) ; 
} 


(continues) 
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(continued) 


5. Add closing curly braces for the main® method and for the class. 
356 





6. Save the file as YLoop.java, and then compile and execute it. Figure 7-5 
shows the input dialog box that appears. Whether the user enters Yes, yes, 
yeah, Yup, Y, or y, the loop will continue. When the user enters anything that 
does not start with y or Y, the loop ends. (If the user clicks OK without 
entering anything in the dialog box, an error message is displayed and the 
program ends abruptly. You will learn to manage this type of error in the 
chapter Exception Handling.) 


Do you want to see a greeting? 
lYes 











Figure 7-5 Dialog box displayed by the YLoop application 


Examining the Character Class at the Java Web Site 


1. Using a Web browser, go to the Java Web site at 
www.oracle.com/technetwork/java/index.html, and select 
Java APIs and Java SE 7. Using the alphabetical list of classes, find the 
Character Class and select it. 


2. Examine the extensive list of methods for the Character class. Find one 
with which you are familiar, such as toLowerCase(). Notice that there are 
two overloaded versions of the method. The one you used in the YLoop 
application accepts a char and returns a char. The other version that 
accepts and returns an int uses Unicode values. Appendix B of this book 
provides more information on Unicode. 
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Declaring and Comparing String Objects 


You learned in Chapter 1 that a sequence of characters enclosed within double quotation 

marks is a literal string. (Programmers might also call it a “string literal.”) You have used many 

literal strings, such as “First Java application”, and you have assigned values to String objects 

and used them within methods, such as print1n() and showMessageDialog(). A literal 357 
string is an unnamed object, or anonymous object, of the String class, and a String variable 
is simply a named object of the same class. The class String is defined in java. lang. String, 
which is automatically imported into every program you write. 








You have declared a String array named args in every main() method header that you have written. 
Y You will learn about arrays in the next chapter. 


When you declare a String object, the String itself—that is, the series of characters contained 
in the String—is distinct from the identifier you use to refer to it. You can create a String 
object by using the keyword new and the String constructor, just as you would create an object 
of any other type. For example, the following statement defines an object named aGreeting, 
declares it to be of type String, and assigns an initial value of “Hello” to the String: 


String aGreeting = new String("Hello"); 


The variable aGreeting stores a reference to a String object—it keeps track of where the 
String object is stored in memory. When you declare and initialize aGreeting, it links to the 
initializing String value. Because Strings are declared so routinely in programs, Java 
provides a shortcut, so you can declare a String containing “Hello” with the following 
statement that omits the keyword new and does not explicitly call the class constructor: 


String aGreeting = "Hello"; 


Comparing String Values 


In Java, String is a class, and each created String is an object. A String variable name is a 
reference; that is, a String variable name refers to a location in memory, rather than to a 
particular value. 


The distinction is subtle, but when you declare a variable of a basic, primitive type, such as 
int x = 10;, the memory address where x is located holds the value 10. If you later assign a 
new value to x, the new value replaces the old one at the assigned memory address. For 
example, if you code x = 45;, then 45 replaces 10 at the address of x. 


In contrast, when you declare a String, such as String aGreeting = "Hello";, aGreeting 
does not hold the characters “Hello”; instead it holds a memory address where the characters 
are stored. 


The left side of Figure 7-6 shows a diagram of computer memory if aGreeting happens to be 
stored at memory address 10876 and the String “Hello” happens to be stored at memory 
address 26040. You cannot choose the memory address where a value is stored. Addresses 
such as 10876 and 26040 are chosen by the operating system. 
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String aGreeting = "Hello"; String aGreeting = "Hello"; 
aGreeting = "Bonjour"; 


Address 10876, named aGreeting Address 10876, named aGreeting 





aGreeting aGreeting 
holds the address holds the address 
where “Hello” is Address 26040 where “Bonjour” Address 26040 


stored. 





is stored. 
Hello 


Address 32564 Address 32564 


XXYYZZ223 Bonjour 





Figure 7-6 Contents of aGreeting at declaration and after an assignment 


When you refer to aGreeting, you actually are accessing the address of the characters you 
want to use. (In the example on the left side of Figure 7-6, the memory location beginning at 
address 32564 has not yet been used and holds garbage values.) 


If you subsequently assign a new value to aGreeting, such as aGreeting = "Bonjour";, 
the address held by aGreeting is altered; now, aGreeting holds a new address where the 
characters “Bonjour” are stored. As shown on the right side of Figure 7-6, “Bonjour” is an 
entirely new object created with its own location. The “Hello” String is still in memory, but 
aGreeting no longer holds its address. Eventually, a part of the Java system called the garbage 
collector discards the “Hello” characters. Strings, therefore, are never actually changed; 
instead, new Strings are created and String references hold the new addresses. Strings 
and other objects that can’t be changed are immutable. 


G 


The creators of Java made Strings immutable for several reasons. For example, in environments 
where multiple programs (or parts of programs, called threads of execution) run concurrently, one 
logical path cannot change a String being used by another path. The compiler can also be made 

to execute more efficiently with immutable String objects. In simple programs, you don’t care 

much about these features. However, immutability leads to performance problems. Later in this chapter, 
you will learn that if you want to use a mutable object to hold strings of characters, you can use the 
StringBuilder class. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce! Lear 


g reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





Declaring and Comparing String Objects) 


Because String references hold memory addresses, making simple comparisons between them 
often produces misleading results. For example, recall the TryToCompareStrings application in 
Figure 7-1. In this example, Java evaluates the String variables aName and anotherName as not 
equal because even though the variables contain the same series of characters, one set is 
assigned directly and the other is entered from the keyboard and stored in a different area of 
memory. When you compare Strings with the == operator, you are comparing their memory 359 
addresses, not their values. Furthermore, when you try to compare Strings using the less-than 

( < ) or greater-than ( > ) operator, the program will not even compile. 








If you declare two String objects and initialize both to the same value, the value is stored 
only once in memory and the two object references hold the same memory address. Because 
the String is stored just once, memory is saved. Consider the following example in which 
the same value is assigned to two Strings (as opposed to getting one from user input). The 
reason for the output in the following example is misleading. When you write the 

following code, the output is Strings are the same. 


String firstString = "abc"; 

String secondString = "abc"; 

if(firstString == secondString) 
System.out.printinC("Strings are the same"); 


The output is Strings are the same because the memory addresses held by firstString and 
secondString are the same, not because their contents are the same. 


Fortunately, the String class provides you with a number of useful methods that compare 
Strings in the way you usually intend. The String class equals() method evaluates the 
contents of two String objects to determine if they are equivalent. The method returns 
true if the objects have identical contents, no matter how the contents were assigned. For 
example, Figure 7-7 shows a CompareStrings application, which is identical to the 
TryToCompareStrings application in Figure 7-1 except for the shaded comparison. 


import java.util.Scanner; 
public class CompareStrings 
{ 
public static void main(String[] args) 
{ 
String aName = "Carmen"; 
String anotherName; 
Scanner input = new Scanner(System. in); 


System.out.printC"Enter your name > "); 
anotherName = input.nextLineQ; 
ifCaName. equals (anotherName) ) 

System.out.printIn(aName + 
else 


equals " + anotherName) ; 


" 


System.out.print]n(aName + " does not equal + anotherName) ; 





Figure 7-7 The CompareStrings application 
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When a user runs the CompareStrings application and enters “Carmen” for the name, the 
output appears as shown in Figure 7-8; the contents of the Strings are equal. The String 
class equals() method returns true only if two Strings are identical in content. Thus, a 
String that refers to “Carmen ” (with a space after the 1) is not equivalent to a String that 
refers to “Carmen” (with no space after the 7). 
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ro 


Command Prompt 


C:\Java>java CompareStrings 
Enter your name > Carmen 
Carmen equals Carmen 


C:z\Java>—_ 








Figure 7-8 Output of the CompareStrings application 


performs a lexicographical comparison—a comparison based on the integer Unicode values of 


Technically, the equals) method does not perform an alphabetical comparison with Strings; it 
Y the characters. 


Each String declared in Figure 7-7 (aName and anotherName) is an object of type String, 
so each String has access to the String class equals() method. If you analyze how the 
equals() method is used in the application in Figure 7-7, you can tell quite a bit about 
how the method was written by Java’s creators: 


e Because you use the equals() method with a String object and the method uses the 
unique contents of that object to make a comparison, you can tell that it is not a static 
method. 


e Because the call to the equals() method can be used in an if statement, you can tell that 
it returns a Boolean value. 


e Because you see a String used between the parentheses in the method call, you can tell 
that the equals() method takes a String argument. 


So, the method header of the equals() method within the String class must be similar to the 
following: 


public boolean equals(String s) 


The only thing you do not know about the method header is the local name used for the 
String argument—it might be s, or it might be any other legal Java identifier. When you use a 
prewritten method such as equals(), you do not know how the code looks inside it. For 
example, you do not know whether the equals() method compares the characters in the 
Strings from left to right or from right to left. All you know is that the method returns true if 
the two Strings are completely equivalent and false if they are not. 
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Because both aName and anotherName are Strings in the application in Figure 7-7, the aName 
object can call equals() with aName.equals(anotherName) as shown, or the anotherName 
object could call equals© with anotherName.equals(aName). The equals() method can 
take either a variable String object or a literal string as its argument. 


The String class equalsIgnoreCase() method is similar to the equals() method. As its 
name implies, this method ignores case when determining if two Strings are equivalent. 
Thus, if you declare a String as String aName = "Carmen";, then aName. equals ("caRMen") 
is false, but aName.equalsIgnoreCase("caRMen") is true. This method is useful when users 
type responses to prompts in your programs. You cannot predict when a user might use the 
Shift key or the Caps Lock key during data entry. 
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When the String class compareTo() method is used to compare two Strings, it provides 
additional information to the user in the form of an integer value. When you use compareTo() 
to compare two String objects, the method returns zero only if the two Strings refer to the 
same value. If there is any difference between the Strings, a negative number is returned if 
the calling object is “less than” the argument, and a positive number is returned if the calling 
object is “more than” the argument. Strings are considered “less than” or “more than” each 
other based on their Unicode values; thus, “a” is less than “b”, and “b” is less than “c”. For 
example, if aName refers to “Roger”, then aName.compareTo("Robert"); returns a 5. The 
number is positive, indicating that “Roger” is more than “Robert”. This does not mean that 
“Roger” has more characters than “Robert”; it means that “Roger” is alphabetically “more” 
than “Robert”. The comparison proceeds as follows: 


e The R in “Roger” and the R in “Robert” are compared, and found to be equal. 
e Theo in “Roger” and the o in “Robert” are compared, and found to be equal. 


e The gin “Roger” and the b in “Robert” are compared; they are different. The numeric 
value of g minus the numeric value of b is 5 (because g is five letters after b in the 
alphabet), so the compareTo() method returns the value 5. 


Often, you won't care what the specific return value of compareTo() is; you simply 
want to determine if it is positive or negative. For example, you can use a test such as 
if(aWord.compareTo(anotherWord) < 0) to determine whether aWord is alphabetically 
less than anotherWord. If aWord is a String variable that refers to the value “hamster”, 
and anotherwWord is a String variable that refers to the value “iguana”, the comparison 
if(aWord.compareTo(anotherWord) < 0) yields true. 


Empty and nul1 Strings 


Programmers are often confused by the difference between empty Strings and nu11 
Strings. You can create an empty String named word! and two nu11 Strings named word2 
and word3 with the following statements: 


win, 


String word1 
String word2 = null; 
String word3; 


Il 
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The empty String word1 references a memory address where no characters are stored. The 
null String word2 uses the Java keyword nu11 so that word2 does not yet hold a memory 
address. The unassigned String word3 is also a null String by default. A significant 
difference between these declarations is that word1 can be used with the String methods 
described in this chapter, but word2 and word3 cannot. For example, assuming a String named 
362 someOtherString has been assigned a value, then the comparison 

word1.equals(someOtherString) is valid, but word2.equals(someOtherString) causes 

an error. 





Because Strings are set to nul1 by default, some programmers think explicitly setting a 
String to null is redundant. Other programmers feel that explicitly using the keyword nu11 
makes your intentions clearer to those reading your program. You should use the style your 
organization recommends. 


ee aig 
—) Watch the video Comparing Strings. 





Declaring and Comparing String Objects 


1. To create a String object, you must use the keyword new and explicitly call the 
class constructor. 


2. When you compare Strings with the == operator, you are comparing their 
memory addresses, not their values. 


3. When you compare Strings with the equals( method, you are comparing 
their values, not their memory addresses. 


"JOJONIYSUOD HuLsrs ay} SUIJed AjOdXa JNoYyyM pue mau PAOMAdy 
3Y} INOYWM JO YUM JOaIGO HuLsas e a}easD ULD NO) “TH SI JUaWa}e}s asje} aU] 


aN You Do It 


Examining the String Class at the Java Web Site 
In this section, you learn more about the String class. 


1. Using a Web browser, go to the Java Web site, and select Java APIs and 
Java SE 7. Using the alphabetical list of classes, find the String class and 


select it. 
(continues) 
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(continued) 


2. Examine the equals() method. In the last section you saw this method used 
in expressions such aS aName. equals(anotherName). Because equals() IS 
used with the object aName, you could predict that the equals( method is 363 
not static. When you look at the documentation for the equals(© method, 
you can see this is true. You also can see that it returns a boolean value. 
What you might have predicted is that the equalsq) method takes a String 
argument, because anotherName IS a String. However, the documentation 
shows that the equals( method accepts an Object argument. You will learn 
more about the Object class in the chapter Advanced Inheritance Concepts, 
but for now understand that a String is a type of Object. Object is a class 
from which all other classes stem. In Java, every class is a type of Object. 








Using Other String Methods 


A wide variety of additional methods are available with the String class. The methods 
toUpperCase() and toLowerCase() convert any String to its uppercase or lowercase 
equivalent. For example, if you declare a String as String aWord = "something";, then the 
string “something” is created in memory and its address is assigned to aWord. The statement 
aWord = aWord.toUpperCase() creates “SOMETHING” in memory and assigns its address to 
aWord. Because aWord now refers to “SOMETHING,” aWord = aWord.toLowerCase() alters aWord 
to refer to “something”. 


The lengthQ) method is an accessor method that returns the length of a String. For 
example, the following statements result in the variable len that holds the value 5. 


String greeting = "Hello"; 
int len = greeting. lengthQ; 


In Chapter 2, you learned that your own accessor methods often start with the prefix get. The creators of 
Java did not follow this convention when naming the JengthQ method. 





When you must determine whether a String is empty, it is more efficient to compare its 
length to 0 than it is to use the equals() method. 


The indexOf() method determines whether a specific character occurs within a String. 
If it does, the method returns the position of the character; the first position of a String 
is zero. The return value is —1 if the character does not exist in the String. For example, 
in String myName = "Stacy";, the value of myName. indexOf('S') is “O”, the value of 
myName.indexOf('a') is “2”, and the value of myName.indexOf('q') is “-1”. 
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The charAt() method requires an integer argument that indicates the position of the 
character that the method returns, starting with 0. For example, if myName is a String that 
refers to “Stacy”, the value of myName.charAt(0) is “S” and the value of myName.charAt (4) is 


y’. An error occurs if you use an argument that is negative, or greater than or equal to the 
length of the calling String . Instead of using a constant argument with charAt(), frequently 





364 you will want to use a variable argument to examine every character in a loop. For example, to 
count the number of spaces in the String mySentence, you might write a loop like the 
following: 
for(int x = 0; x < myName.length(); ++x) 

if (mySentence.charAt(x) == ' ') 
++countOfSpaces; 


The endswith() method and the startsWith() method each take a String argument and 
return true or false if a String object does or does not end or start with the specified 
argument. For example, if String myName = "Stacy";, then myName.startsWith("Sta") is 
true, and myName.endswith("z") is false. These methods are case sensitive, so if String 
myName = "Stacy";, then myName.startsWith("sta") is false. 


The replace() method allows you to replace all occurrences of some character 
within a String. For example, if String yourName = "Annette";, then String 
goofyName = yourName.replace('n', 'X'); assigns "AXXette" to goofyName 

The statement goofyName = yourName.replace('p', 'X'); would assign "Annette" 
to goofyName without any changes because 'p' is not found in yourName. 

The replace() method is case sensitive, so if String yourName = "Annette";, 
then String goofyName = yourName.replace('N', 'X'); results in no change. 


Although not part of the String class, the toStringQ method is useful when working with 
String objects. It converts any object to a String. In particular, it is useful when you want to 
convert primitive data types to Strings. So, if you declare theString and someInt = 4;, as 
follows, then after the following statements, theString refers to “4”: 


String theString; 
int someInt = 4; 
theString = Integer.toString(someInt) ; 


If you declare another String and a double as follows, then after the following statements, 
aString refers to “8.25”: 


String aString; 
double someDouble = 8.25; 
aString = Double.toString(someDoub1e) ; 


You also can use concatenation to convert any primitive type to a String. You can join a 
simple variable to a String, creating a longer String using the + operator. For example, if you 
declare a variable as int myAge = 25;, the following statement results in aString that refers 
to “My age is 25”: 


" 


String aString = "My age is " + myAge; 
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Similarly, if you write the following, then anotherString refers to “12.34”. 


String anotherString; 
float someFloat = 12.34f; 
anotherString = "" + someFloat; 


The Java interpreter first converts the float 12.34f to a String “12.34” and adds it to the empty 365 
String “” 








that you can use with any type of object. In the chapter Advanced Inheritance Concepts, you will 
learn how to construct versions of the method for your own classes and that toString() originates 
in the Object class. You have been using toString() throughout this book without knowing it. 
When you use print() and printinQ), their arguments are automatically converted to 

Strings if necessary. You don’t need import statements to use toString() because it is part 
of java. lang, which is imported automatically. Because the toString() method you use with 
printInQ takes arguments of any primitive type, including int, char, double, and so on, it is 
a working example of polymorphism. 


Q The toStringQ method does not originate in the String class; it is a method included in Java 


You already know that you can concatenate Strings with other Strings or values by 
using a plus sign ( + ); you have used this approach in methods such as printInQ) and 
showMessageDialog() since Chapter 1. For example, you can display a firstName, a 
space, and a lastName with the following statement: 


mow 


System.out.printIn(firstName + + lastName); 


In addition, you can extract part of a String with the substring() method and use it 
alone or concatenate it with another String. The substring() method takes two integer 
arguments—a start position and an end position—that are both based on the fact that a 
String’s first position is position zero. The length of the extracted substring is the 
difference between the second integer and the first integer; if you call the method 
without a second integer argument, the substring extends to the end of the original 
string. 


For example, the application in Figure 7-9 prompts the user for a customer’s first 
and last names. The application then extracts these names so that a friendly business 
letter can be constructed. After the application prompts the user to enter a name, 

a loop control variable is initialized to 0. While the variable remains less than the 
length of the entered name, each character is compared to the space character. When 
a space is found, two new strings are created. The first, FirstName, is the substring 
of the original entry from position 0 to the location where the space was found. 

The second, familyName, is the substring of the original entry from the position after 
the space to the end of the string. Once the first and last names have been created, 
the loop control variable is set to the length of the original string so the loop will 
exit and proceed to the display of the friendly business letter. Figure 7-10 shows the 
data entry screen as well as the output letter created. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 7 Characters, Strings, and the StringBuilder 


import javax.swing.*; 
public class BusinessLetter 
{ 
public static void main(String[] args) 
366 { 





String name; 

String firstName = ""; 

String familyName = ""; 

int x; 

char c; 

name = JOptionPane.showInputDialog(null, 
"Please enter customer's first and last name"); 
0; 

while(x < name. length()) 

{ 
ifC(name.charAt(x) == ' ') 
{ 


firstName = name.substring(O, x); 
familyName = name.substring(x + 1, name.lengthQ); 
x = name. length(); 


} 
+4+X} 

} 

JOptionPane.showMessageDialog(null, 
"Dear " + firstName + 
",\nI am so glad we are on a first name basis" + 
"\nbecause I would like the opportunity to" + 
"\ntalk to you about an affordable insurance" + 
"\nprotection plan for the entire " + familyName + 
"\nfamily. Call A-One Family Insurance today" + 
"\nat 1-800-555-9287."); 





Figure 7-9 The BusinessLetter application 


customer. An actual business application would most likely allow a clerk to enter dozens or even hundreds of 
customer names and store them in a data file for future use. You will learn to store data permanently in files in 
the chapter File Inout and Output. For now, just concentrate on the string-handling capabilities of the 
application. 


Q To keep the example simple, the BusinessLetter application in Figure 7-9 displays a letter for just one 
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Dear Sophia, 

lam so glad we are on a first name basis 

because | would like the opportunity to 

talk to you about an affordable insurance 367 
Please enter customer's first and last name protection plan for the entire Robertson 
| family. Call A-One Family Insurance today 
at 1-800-555-9287. 


Cancel 











[Sophia Robertson 























Figure 7-10 Typical execution of the BusinessLetter application 


The regionMatches() method can be used to test whether two String regions are the same. 
One version of the regionMatches() method takes four arguments—the position at which to 
start in the calling String, the other String being compared, the position to start in the other 
String, and the length of the comparison. For example, suppose that you have declared two 
String objects as follows: 


String firstString = "abcde"; 
String secondString = "xxbcdef"; 


Then, the expression firstString.regionMatches(1, secondString, 2, 4) is true 
because the four-character substring starting at position 1 in firstString is "bcde" and the 
four-character substring starting at position 2 in secondString is also "bcde". The expression 
firstString.regionMatches(0, secondString, 3, 2) is false because the two-character 
substring starting at position 0 in firstString is "ab" and the two-character substring 
starting at position 3 in secondString is "cd". 


A second version of the regionMatches() method takes an additional boolean argument as 
the first argument. This argument represents whether case should be ignored in deciding 
whether regions match. For example, suppose that you have declared two Strings as follows: 


String thirdString = "123 Maple Drive"; 
String fourthString = "a maple tree"; 


Then the following expression is true because the substring of thirdString that starts at 
position 4 and continues for five characters is "Maple", the substring of fourthString that 
starts at position 2 and continues for five characters is "maple", and the argument that 
ignores case has been set to true: 


thirdString.regionMatches(true, 4, fourthString, 2, 5) 
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Using Other String Methods 


368 1. Assume that myName is a String defined as “molly”. The value 
of myName. toUpperCase() Is “Molly”. 





2. Assume that myName is a String defined as “molly”. The value of 
myName. Tength() is “dD”. 


3. Assume that myName is a String defined as “molly”. The value 
of myName.indexOf('M') is —l. 


“WATIOW) S! 
Qasejsaddpo2* aweyAw Uday} ‘AlJOUW,, SI aweNAw J] “T# SI JUaWAa}e}S asje} aU] 


aN You Do It 


Using String Class Methods 


To demonstrate the use of the String methods, in this section you create an 
application that asks a user for a name and then “fixes” the name so that the first letter 
of each new word is uppercase, whether or not the user entered the name that way. 


1. Open a new text file in your text editor. Enter the following first few lines of 
a RepairName program. The program declares several variables, including 
two strings that will refer to a name: one will be “repaired” with correct 
capitalization; the other will be saved as the user entered it so it can be 
displayed in its original form at the end of the program. After declaring 
the variables, prompt the user for a name: 


import javax.swing.*; 
public class RepairName 
{ 
public static void main(String[] args) 
{ 
String name, saveOriginalName; 
int stringLength; 
int i; 
char c; 
name = JOptionPane.showInputDialog(null1, 
"Please enter your first and last name"); 


(continues) 
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(continued) 


2. Store the name entered in the saveOriginalName variable. Next, calculate 
the length of the name the user entered, then begin a loop that will examine 
every character in the name. The first character of a name is always capitalized, 369 
so when the loop control variable i is 0, the character in that position in the 
name string is extracted and converted to its uppercase equivalent. Then the 
name is replaced with the uppercase character appended to the remainder 
of the existing name. 








saveOriginalName = name; 
stringLength = name. lengthQ); 
for(i=0; i < stringLength; i++) 


{ 
c = name.charAt(i); 
ifGi == 0) 
{ 


c = Character. toUpperCase(c) ; 
name = c + name.substring(1, stringLength) ; 


} 


3. After the first character in the name is converted, the program looks through 
the rest of the name, testing for spaces and capitalizing every character that 
follows a space. When a space is found at position i, i is increased, the next 
character is extracted from the name, the character is converted to its 
uppercase version, and a new name string is created using the old string up 
to the current position, the newly capitalized letter, and the remainder of the 
name string. The if..else ends and the for loop ends. 


else 

ifCname.charAt(i) == ' ') 

{ . 
+41; 
c = name.charAt(i); 
c = Character.toUpperCase(c) ; 
name = name.substring(O, i) + c + 

name.substring(i + 1, stringLength); 


} 


4. After every character has been examined, display the original and repaired 
names, and add closing braces for the main© method and the class. 


JOptionPane.showMessageDialog(null, "Original name was " + 
saveOriginalName + "\nRepaired name is " + name); 


(continues) 
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(continued) 


5. Save the application as RepairName.java, and then compile and run the 
program. Figure 7-11 shows a typical program execution. Make certain you 
370 understand how all the string methods contribute to the success of this 
program. 





Message 











Please enter your first and last name (i) Original name was billy flynn 


Nee 


[billy flynn Repaired name is Billy Flynn 





























Figure 7-11 Typical execution of the Repai rName application 


Converting String Objects to Numbers 


If a String contains all numbers, as in “649”, you can convert it from a String to a number 
so you can use it for arithmetic or you can use it like any other number. For example, 
suppose you ask a user to enter a salary in an input dialog box. When you accept input using 
showInputDialog(), the accepted value is always a String. To be able to use the value in 
arithmetic statements, you must convert the String to a number. 


the String does not represent a valid number (for example, if it contains letters), or the String 
represents the wrong kind of number (for example, it contains a decimal point but is being converted to an 
integer), an error called a NumberFormatException occurs. You will learn about exceptions in the 
chapter Exception Handling. 


Q When you use any of the methods described in this section to attempt to convert a String to a number, but 


To convert a String to an integer, you use the Integer class, which is part of java. lang and 
is automatically imported into programs you write. The Integer class is an example of a 
wrapper. A wrapper is a class or object that is “wrapped around” a simpler element; the 
Integer wrapper class contains a simple integer and useful methods to manipulate it. You 
have already used the parseInt() method, which is part of the Integer class; it takes a 
String argument and returns its integer value. For example, the following statement stores 
the numeric value 649 in the variable anInt: 


int anInt = Integer.parseInt("649") ; 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Converting String Objects to Numbers D0 


You can then use the integer value just as you would any other integer. You can tell that 
parseInt() is a static method because you use it with the class name and not with an object. 


Alternatively, you can use the Integer class valueOf() method to convert a String to an 
Integer class object, and then use the Integer class intValue() method to extract 

the simple integer from its wrapper class. The ConvertStringToInteger application in 
Figure 7-12 shows how you can accomplish the conversion. When the user enters a String in 
the showInputDialog() method, the String is stored in stringHours. The application then 
uses the valueOf() method to convert the String to an Integer object and uses the 
intValue() method to extract the integer. When the user enters “37” as the String, it is 
converted to a number that can be used in a mathematical statement, and the output appears 
as expected; this output is shown in Figure 7-13. 


371 








import javax.swing.JOptionPane; 
public class ConvertStringToInteger 
{ 
public static void main(String[] args) 
{ 
String stringHours; 
int hours; 
Integer integerHours; 
final double PAY_RATE = 12.25; 
stringHours = JOptionPane.showInputDialog(null, 
"How many hours did you work this week?"); 
integerHours = Integer.valueOf(stringHours) ; 
hours = integerHours.intValue(); 
JOptionPane.showMessageDialog(null, "You worked " + 
hours + " hours at $" + PAY_RATE + " per hour" + 
"\nThat's $" + Chours * PAY_RATE)); 





How many hours did you work this week? You worked 37 hours at $12.25 per hour 
[37 | That's $453.25 


























Figure 7-13 Typical execution of the ConvertStringToInteger application 
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It is also easy to convert a String object to a double value. You must use the Double class, 
which, like the Integer class, is a wrapper class and is imported into your programs 

automatically. The Double class parseDouble() method takes a String argument and returns 
its double value. For example, the following statement stores the numeric value 147.82 in the 


variable doubleValue. 
372 





double doubleValue = Double.parseDouble("147.82"); 
To convert a String containing “147.82” to a double, you also can use the following code: 


String stringValue = new String("147.82"); 
Double tempValue = Double. valueOf(stringValue) ; 
double value = tempValue.doubleValueQ ; 


In this example, stringValue is passed to the Double. valueOf() method, which returns a 
Double object. The doubleValue() method is used with the tempValue object; this method 
returns a simple doub1e that is stored in value. 


The methods parseInt() and parseDouble() are newer than the valueOf() methods, and many 
programmers prefer to use them when writing new applications. 


Besides Doub1e and Integer, other wrapper classes such as Float and Long also provide valueOf () 
methods that convert Strings to the wrapper types. Additionally, the classes provide parseFloat() and 
parseLong() methods, respectively. 


YY 


ee 
a) Watch the video String Methods. 





Converting String Objects to Numbers 


1. The Integer and Double classes are wrapper classes. 
2. The value of Integer.parseInt("22.22") is 22. 
3. The value of Double. parseDouble("22.22") is 22.22. 
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\ You Do It 


Converting a String to an Integer 
373 








In the next steps, you write a program that prompts the user for a number, reads 
characters from the keyboard, stores the characters in a String, and then converts 
the String to an integer that can be used in arithmetic statements. 


1. Open a new text file in your text editor. Type the first few lines of a 
NumberInput Class that will accept string input: 
import javax.swing.*; 
public class NumberInput 


{ 
public static void main(String[] args) 


{ 


2. Declare the following variables for the input String, the integer to which it is 
converted, and the result: 
String inputString; 


int inputNumber; 
int result; 


3. Declare a constant that holds a multiplier factor. This program will multiply the 
user’s input by 10: 


final int FACTOR = 10; 


4. Enter the following input dialog box statement that stores the user keyboard 
input in the String variable inputString: 


inputString = JOptionPane.showInputDialog(null, 
"Enter a number"); 


5. Use the following Integer. parseInt© method to convert the input String to 
an integer. Then multiply the integer by 10 and display the result: 


inputNumber = Integer.parseInt(inputString) ; 
result = inputNumber * FACTOR; 
JOptionPane. showMessageDialog(null, 
inputNumber + " * " + FACTOR + " = " + result); 


6. Add the final two closing curly braces for the program, then save the program 
as Numberlnput.java and compile and test the program. Figure 7-14 shows 
a typical execution. Even though the user enters a String, it can be used 
successfully in an arithmetic statement because it was converted using the 
parseInt() method. 


(continues) 
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(continued) 


Message 




















Enter a number ro 
42 Gi) 42*10=420 


_Cancel 

















Figure 7-14 Typical execution of the NumberInput program 


Examining the parseInt() Method at the Java Web Site 


1. Using a Web browser, go to the Java Web site, and select Java APIs and 
Java SE 7. Using the alphabetical list of classes, find the Integer class and 
select it. 


2. Find the parseIntQ method that accepts a String parameter and examine 
it. You can see that the method is static, which is why you use it with the 
class name Integer and not with an object. You also see that it returns an 
int. You have used this method since the earliest chapters of this book, but 
now that you understand classes, objects, and methods, you can more easily 
interpret the Java documentation. 


Learning About the StringBuilder 
and StringBuffer Classes 


In Java, the value of a String is fixed after the String is created; Strings are immutable, 
or unchangeable. When you write someString = "Hello"; and follow it with 

someString = "Goodbye";, you have neither changed the contents of computer memory 

at the address represented by someString nor eliminated the characters “Hello”. Instead, 
you have stored “Goodbye” at a new computer memory location and stored the new address 
in the someString variable. If you want to modify someString from “Goodbye” to “Goodbye 
Everybody”, you cannot add a space and “Everybody” to the someString that contains 
“Goodbye”. Instead, you must create an entirely new String, “Goodbye Everybody”, and 
assign it to the someString address. If you perform many such operations with Strings, you 
end up creating many different String objects in memory, which takes time and resources. 


To circumvent these limitations, you can use either the StringBuilder or StringBuffer 
class. You use one of these classes, which are alternatives to the String class, when you know 
a String will be modified; usually, you can use a StringBuilder or StringBuffer object 


Learning About the StringBui Ider and StringBuffer Classes D0 


anywhere you would use a String. Like the String class, these two classes are part of the 
java. lang package and are automatically imported into every program. The classes are 
identical except for the following: 


e StringBuilder is more efficient. 


e StringBuffer is thread safe. This means you should use it in applications that run 375 
multiple threads of execution, which are units of processing that are scheduled by an 
operating system and that can be used to create multiple paths of control during program 
execution. Because most programs you write (and all the programs you will write using 
this book) contain a single thread, usually you should use StringBuilder. 








The rest of this section discusses StringBuilder, but every statement is also true of 
StringBuffer. 


You can create a StringBuilder object that contains a String with a statement such as the 
following: 


StringBuilder message = new StringBuilderC"Hello there"); 


When you use the nextLineQ method with a Scanner object for console input or a 
JOptionPane.showInputDialog() method for GUI input, user input almost always comes 
into your program as a String. If you want to work with the input as a StringBuilder object, 
you can convert the String using the StringBui Ider constructor. For example, the following 
statement gets a user’s input using a Scanner object named keyboard and then stores it in the 
StringBuilder name: 


StringBuilder name = new StringBui lder(keyboard.nextLine()); 


When you create a String, you have the option of omitting the keyword new, but when you 
initialize a StringBuilder object you must use the keyword new, the constructor name, and 
an initializing value between the constructor’s parentheses. You can create an empty 
StringBuilder variable using a statement such as the following: 


StringBuilder uninitializedString = null; 


The variable does not refer to anything until you initialize it with a defined StringBuilder 
object. Generally, when you create a String object, sufficient memory is allocated to 
accommodate the number of Unicode characters in the string. A StringBuilder object, 
however, contains a memory block called a buffer, which might or might not contain a string. 
Even if it does contain a string, the string might not occupy the entire buffer. In other words, 
the length of a string can be different from the length of the buffer. The actual length of the 
buffer is the capacity of the StringBuilder object. 


You can change the length of a string in a StringBuilder object with the 
setLength() method. The length of a StringBuilder object equals the number of 
characters in the String contained in the StringBuilder. When you increase a 
StringBuilder object’s length to be longer than the String it holds, the extra characters 
contain ‘\u0000’. If you use the setLength() method to specify a length shorter than 
its String, the string is truncated. 
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To find the capacity of a StringBuilder object, you use the capacity() method. The 
StringBui 1derDemo application in Figure 7-15 demonstrates this method. The application 
creates a nameString object containing the seven characters “Barbara”. The capacity of the 


StringBuilder object is obtained and stored in an integer variable named 
nameStringCapacity and displayed. 


import javax.swing.JOptionPane; 
public class StringBuilderDemo 


{ 


public static void main(String[] args) 


{ 





StringBuilder nameString = new StringBuilder(C"Barbara") ; 

int nameStringCapacity = nameString.capacityQ; 

System.out.printIn("Capacity of nameString is " + 
nameStringCapacity) ; 


StringBuilder addressString = null; 


addressString = new 
StringBui lder("6311 Hickory Nut Grove Road"); 
int addStringCapacity = addressString.capacity(); 
System.out.printInC"Capacity of addressString is " + 
addStringCapacity) ; 
nameString.setLength(20) ; 
System.out.printIn("The name is 
addressString.setLength(20) ; 
System.out.printIn("The address is 


+ nameString + "end"); 


+ addressString) ; 


Figure 7-15 The StringBui 1derDemo application 


Figure 7-16 shows the StringBuilder capacity is 23, which is 16 characters more than the 
length of the string “Barbara”. Whenever you create a StringBuilder object, its capacity is 
the length of the String contained in StringBuilder, plus 16. The “extra” 16 positions allow 
for reasonable modification of the StringBuilder object after creation without allocating any 


new memory locations. 
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Java> java Str ingBui ilderDemo 


et 
a3 


apacity of nameStr ing is 
Capacity of addres sString is 43 
> name is Barbara. end 


addres is 6311 Hickory Nut Gro 377 








>> \Java> 








Figure 7-16 Output of the StringBui IlderDemo application 


The creators of Java chose 16 characters as the “extra” length for a StringBui Ider object 

because 16 characters fully occupy four bytes of memory. As you work more with computers in general 
and programming in particular, you will notice that storage capacities are almost always created in 
exponential values of 2—for example, 4, 8, 16, 32, 64, and so on. 





In the application in Figure 7-15, the addressString variable is created as 
StringBuilder addressString = nul1;. The variable does not refer to anything until 
it is initialized with the defined StringBuilder object in the following statement: 


addressString = new StringBuilder("6311 Hickory Nut Grove Road"); 


The capacity of this new StringBuilder object is shown in Figure 7-16 as the length of the 
string plus 16, or 43. 


In the application shown in Figure 7-15, the length of each of the Strings is changed to 20 
using the setLength() method. The application displays the expanded nameString and 
“end”, so you can see in the output that there are 13 extra spaces at the end of the String. 
The application also displays the truncated addressString so that you can see the effect of 
reducing its length to 20. 


Using StringBuilder objects provides improved computer performance over String objects 
because you can insert or append new contents into a StringBuilder. In other words, unlike 
immutable Strings, the ability of StringBuilder objects to be modified makes them more 
efficient when you know string contents will change. 


Although the equals( method compares String object contents, when you use it with 
StringBuilder objects, it compares references. You can compare the contents of two 
StringBuilder objects named obj1 and obj2 by converting them to Strings with an 
expression such as the following: 


obj1.toStringQ .equals(obj2.toStringQ) 
The StringBuilder class provides you with four constructors as follows: 


e public StringBuilderQ constructs a StringBuilder with no characters and a default 
size of 16 characters. 


e public StringBuilder(int capacity) constructs a StringBuilder with no characters 
and a capacity specified by the parameter. 
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e public StringBuilder(String s) contains the same characters as those stored in the 
String object s. The capacity of the StringBuilder is the length of the String argument 
you provide, plus 16 additional characters. 


e The fourth StringBuilder constructor uses an argument of type CharSequence. CharSequence 
is another Java class; it is an interface that holds a sequence of char values. You will 


378 . ; ; 
learn to create interfaces in the chapter Advanced Inheritance Concepts. 





The append() method lets you add characters to the end of a StringBuilder object. 
For example, the following two statements together declare phrase to hold “Happy” and 
alter the phrase to hold “Happy birthday”: 


StringBuilder phrase = new StringBuilder(C"Happy") ; 
phrase.append(" birthday") ; 


The insert() method lets you add characters at a specific location within a StringBuilder 
object. For example, if phrase refers to “Happy birthday”, then phrase.insert(6, "30th "); 
alters the StringBuilder to contain “Happy 30th birthday”. The first character in the 
StringBuilder object occupies position zero. 


To alter just one character in a StringBuilder, you can use the setCharAt() method, 
which allows you to change a character at a specified position within a StringBuilder object. 
This method requires two arguments: an integer position and a character. If phrase refers 
to “Happy 30th birthday”, then phrase.setCharAt(6,'4'); changes the value into a 40th 
birthday greeting. 


One way you can extract a character from a StringBuilder object is to use the charAt() 
method. The charAt() method accepts an argument that is the offset of the character 
position from the beginning of a String and returns the character at that position. The 
following statements assign the character ‘P’ to the variable letter: 


StringBuilder text = new StringBuilderC"Java Programming") ; 
char letter = text.charAt(5); 


If you try to use an index that is less than 0 or greater than the index of the last position in the 
StringBuilder object, you cause an error known as an exception and your program 
terminates. 


When you can approximate the eventual size needed for a StringBuilder object, assigning 
sufficient capacity can improve program performance. For example, the program in Figure 7-17 
compares the time needed to append “Java” 20,000 times to two StringBuilder objects— 
one that has the initial default size of 16 characters and another that has an initial size 

of 80,000 characters. Figure 7-18 shows the execution. The extra time needed for the 
loop that uses the shorter StringBuilder is the result of repeatedly assigning new 
memory as the object grows in size. 
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public class CompareConcatenationTimes 
{ 
public static void main(String[] args) 
{ 

long startTimel, startTime2, 379 
endTimel, endTime2; 

final int TIMES = 20000; 

int x; 

StringBuilder stringl = new StringBuilder(""); 

StringBuilder string2 = new StringBuilder(TIMES * 4); 

startTimel = System.currentTimeMillisQ; 

for(x = 0; x < TIMES; ++x) 
stringl.append("Java"); 

endTimel = System.currentTimeMillisQ; 

System.out.printInC"Time for empty StringBuilder 
+ (endTimel - startTimel)+ " milliseconds"); 

startTime2 = System.currentTimeMillisQ; 

for(x = 0; x < TIMES; ++x) 
string2.append("Java"); 

endTime2 = System.currentTimeMillisQ; 

System.out.printInC("Time for large StringBuilder 
+ CendTime2 - startTime2)+ " milliseconds"); 





























Figure 7-17 The CompareConcatenationTimes application 


r 


C:\Java>java CompareConcatenationTimes 
Time for empty StringBuilder : 6 milliseconds 
Time for large StringBuilder : 2 milliseconds 








C=\Java> 











Figure 7-18 Output of the CompareConcatenationTimes program 


You saw a demonstration of the currentTimeMi1l1isQ method in Chapter 6. 
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ee ; ; 
—T) Watch the video StringBu7i Ider. 
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Learning About the StringBuilder and StringBuffer Classes 





1. When you create a String, you have the option of omitting the keyword new, but 
when you initialize a StringBuilder object, you must use the keyword new, the 
constructor name, and an initializing value between the constructor’s 
parentheses. 


2. When you create a StringBuilder object with an initial value of “Juan”, its 
capacity is 16. 


3. Ifa StringBuilder named myAddress contains “817”, then 


myAddress.append(" Maple Lane"); alters myAddress to contain 
“817 Maple Lane”. 


"OZ JO Je}0} e JO} ‘QUOW OT SNid “p ‘sap_LngbuLyas ul 
pauleyuod buLuas ayy} JO YJsua| au} Si AOeded sp ‘,ueNs,, JO anjen jeniul 
ue YIM yalGo uap_LngbuLsrs e ajeasd NOK UUM “Z# SI JUBWA}e}s ase} aU] 


“ne You Do It 


Using StringBuilder Methods 
In these steps, you write a program that demonstrates the StringBuilder class. 


1. Open a new text file, and type the following first lines of a DemoStringBui 1der 
Class: 


public class DemoStringBuilder 
{ 
public static void main(String[] args) 


{ 


2. Use the following code to create a StringBuilder object, and then call a 
printQ method (that you will create in Step 7) to display the StringBuilder: 


(continues) 
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(continued) 
StringBuilder str = new StringBuilder(C"singing") ; 
print(str); 
3. Enter the following appendd method to add characters to the existing 381 
StringBuilder and display it again: 








str.append(" in the dead of "); 
print(str); 


4. Enter the following insert© method to insert characters. Then display the 
StringBuilder, insert additional characters, and display it again: 


str.insert(O, "Black"); 
print(str); 
str.insert(5, "bird "); 
print(str); 


5. Add one more append() and print() combination: 


str.appendC("night"); 
print(str); 


Add a closing curly brace for the main©® method. 
7. Enter the following print method that displays StringBuilder objects: 


public static void print(StringBuilder s) 
{ 


} 


8. Type the closing curly brace for the class, and then save the file as 
DemoStringBuilder.java. Compile and execute, and then compare your 
output to Figure 7-19. 


C:\Java>java DemoStringBuilder 
singing 

singing in the dead of 

Blacksinging in the dead of 

Blackbird singing in the dead of 
Blackbird singing in the dead of night 


System.out.printIn(s) ; 








C:\Java> 








Figure 7-19 Output of the DemoStringBui Ider application 
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Don't Do It 


e Don't attempt to compare String objects using the standard comparison operators. 
The == operator will compare only the addresses of Strings, and the < and > operators 
will not work. 


382 e Don't forget that startswithQ, endsWith(), and replace() are case sensitive, so you 
might want to convert participating Strings to the same case before using them. 





e Don't forget to use the new operator and the constructor when declaring initialized 
StringBuilder or StringBuffer objects. 





Key Terms 


A reference is a variable that holds a memory address. 


The Character Class is one whose instances can hold a single character value. This class also 
defines methods that can manipulate or inspect single-character data. 


The String class is for working with fixed-string data—that is, unchanging data composed of 
multiple characters. 


A String variable is a named object of the String class. 
An anonymous object is an unnamed object. 
Immutable objects cannot be changed. 


The String class equals() method evaluates the contents of two String objects to determine 
if they are equivalent. 


A lexicographical comparison is based on the integer Unicode values of characters. 


The String class equalsIgnoreCase() method is similar to the equals() method. As its 
name implies, it ignores case when determining if two Strings are equivalent. 











The String class compareTo() method is used to compare two Strings; the method returns 
zero only if the two Strings refer to the same value. If there is any difference between the 
Strings, a negative number is returned if the calling object is “less than” the argument, and a 
positive number is returned if the calling object is “more than” the argument. 


A null String does not hold a memory address. 
The String class toUpperCase() method converts any String to its uppercase equivalent. 
The String class toLowerCase() method converts any String to its lowercase equivalent. 


The String class length() method returns the length of a String. 
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The String class indexOf() method determines whether a specific character occurs 
within a String. If it does, the method returns the position of the character; the first 
position of a String begins with zero. The return value is —1 if the character does not 
exist in the String. 


The String class charAt() method requires an integer argument that indicates the position of 383 
the character that the method returns. 








The String class endswith() method takes a String argument and returns true or false ifa 
String object does or does not end with the specified argument. 


The String class startsWith( method takes a String argument and returns true or false if 
a String object does or does not start with the specified argument. 


The String class replace() method replaces all occurrences of some character within 
a String. 


The toString() method converts any object to a String. 

Concatenation is the process of joining a variable to a string to create a longer string. 
The substring() method extracts part of a String. 

The regionMatches() method tests whether two String regions are the same. 


The Integer class is a wrapper class that contains a simple integer and useful methods to 
manipulate it. 


A wrapper is a class or object that is “wrapped around” a simpler element. 


The Integer class parseInt() method takes a String argument and returns its 
integer value. 


The Double class is a wrapper class that contains a simple double and useful methods to 
manipulate it. 


The Double class parseDouble() method takes a String argument and returns its 
doub1e value. 


The StringBuilder class is used as an alternative to the String class because it is more 
efficient if a String’s contents will change. 









The StringBuffer class is an alternative to the String and StringBuilder classes because it 
is efficient and thread safe. 


Threads of execution are units of processing that are scheduled by an operating system and 
that can be used to create multiple paths of control during program execution. 


A buffer is a block of memory. 


The capacity of a StringBuilder object is the actual length of the buffer, as opposed to that 
of the string contained in the buffer. 
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The StringBuilder class setLength() method changes the length of the string in a 
StringBuilder object. 


384 












The StringBuilder class capacity() method returns the actual length, or capacity, of the 
StringBuilder object. 


The StringBuilder class append() method lets you add characters to the end of a 
StringBuilder object. 


The StringBuilder class insert() method lets you add characters at a specific location 
within a StringBuilder object. 


The StringBui Ider class setCharAt() method allows you to change a character at a specified 
position within a StringBuilder object. 


The StringBuilder class charAt() method accepts an argument that is the offset of 
the character position from the beginning of a String and returns the character at 
that position. 


Chapter Summary 


String variables are references, so they require special techniques for making 
comparisons. 


The Character class is one whose instances can hold a single character value. This class 
also defines methods that can manipulate or inspect single-character data. 


A sequence of characters enclosed within double quotation marks is a literal string. You 
can create a String object by using the keyword new and the String constructor. Unlike 
other classes, you also can create a String object without using the keyword new or 
explicitly calling the class constructor. Strings are immutable. Useful String class 
methods include equals(), equalsIgnoreCase(), and compareTo(). 


Additional useful String methods include toUpperCase(), toLowerCase(), lengthQ, 
indexOfQ, charAtQ), endsWithQ, startswWith(), and replace(). The toStringQ 
method converts any object to a String. You can join Strings with other Strings or 
values by using a plus sign ( + ); this process is called concatenation. You can extract part 
of a String with the substringQ method. 


If a String contains appropriate characters, you can convert it to a number with the help 
of the following methods: Integer.parseInt(), Integer.valueOf(), intValue(), 
Double.parseDouble(), Double. valueOf(), and doubleValue(). 


You can use the StringBuilder or StringBuffer class to improve performance when a 
string’s contents must change. 
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Review Questions 


1. Asequence of characters enclosed within double quotation marks is a 








a. symbolic string c. prompt 

b. literal string d. command 385 
2. To create a String object, you can use the keyword ________ before 

the constructor call, but you are not required to use this format. 

a. object c. char 

b. create d. new 


3. A String variable name is a 


a. reference c. constant 
b. value d. literal 


4, The term that programmers use to describe objects that cannot be 


changed is 
a. irrevocable c. immutable 
b. nonvolatile d. stable 


5. Suppose that you declare two String objects as: 


String wordl = new String("happy") ; 
String word2; 


When you ask a user to enter a value for word2, if the user types “happy”, the value 
of word1 == word? is 


a. true c. illegal 
b. false d. unknown 


6. If you declare two String objects as: 


String word1 
String word2 


new String("happy"); 
new String("happy"); 









the value of word1.equals(word2) is 


a. true c. illegal 
b. false d. unknown 


7. The method that determines whether two String objects are equivalent, 
regardless of case, is 


a. equalsNoCase() c. equalsIgnoreCase() 
b. toUpperCase() d. equalsQ 
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8. Ifa String is declared as: 
String aStr = new String("lima bean"); 
then aStr.equals("Lima Bean") is 


a. true c. illegal 


386 b. false d. unknown 





9. Ifyou create two String objects: 


String namel = new String("Jordan") ; 
String name2 = new String("Jore"); 


then name1.compareTo(name2) has a value of 


a. true c —l 
b. false d. 1 


10. If String myFriend = new String("Ginny") ;, which of the following has the 
value 1? 
a. myFriend.compareTo(C"Gabby") ; 
b. myFriend.compareTo("Gabriella"); 
c. myFriend.compareToC"Ghazala") ; 
d 


myFriend.compareToC"Hammie") ; 
11. IfString movie = new String("West Side Story");, the value of 
movie. indexOf('s') is 


a. true 


c. 2 
b. false d. 3 


12. The String class replace() method replaces 











a. a String with a character 

b. one String with another String 

c. one character in a String with another character 

d. every occurrence of a character in a String with another character 
13. The toStringQ method converts a(n) ________ to. a String. 

a. char c. float 

b. int d. all of the above 


14. Joining Strings with a plus sign is called 
a. chaining c. parsing 
b. concatenation d. linking 
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15. The first position in a String 
a. must be alphabetic 
b. must be uppercase 
c. is position zero 
d. is ignored by the compareTo() method 387 

16. The method that extracts a string from within another string is 
a. extractQ c. substring() 
b. parseString() d. appendd 

17. The method parseInt() converts a(n) 
a. integer to a String c. Double to a String 
b. integer to a Double d. String to an integer 

18. The difference between int and Integer is 
a. int is a primitive type; Integer is a class 
b. int is a class; Integer is a primitive type 
c. nonexistent; both are primitive types 
d. nonexistent; both are classes 

19. For an alternative to the String class, and so that you can change a String’s 
contents, you can use 
a. char c. StringBuilder 
b. StringHolder d. StringMerger 

20. Unlike when you create a String, when you create a StringBuilder, you must use 
the keyword 
a. buffer c. null 
b. new d. class 

Exercises 
(=) Programming Exercises 
1. Write an application that prompts the user for three first names and concatenates 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 






them in every possible two-name combination so that new parents can 
easily compare them to find the most pleasing baby name. Save the file as 
BabyNameComparison.java. 
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2. a. Write an application that counts the total number of spaces contained in the 
String “The person who says something is impossible should not interrupt the 
person who is doing it.” Save the file as CountSpaces.java. 


b. Write an application that counts the total number of spaces contained in a String 


388 entered by the user. Save the file as CountSpaces2.java. 





3. Write an application that prompts the user for a String that contains at least five 
letters and at least five digits. Continuously reprompt the user until a valid String is 
entered. Display a message indicating whether the user was successful or did not enter 
enough digits, letters, or both. Save the file as FiveLettersAndFiveDigits.java. 


4, Write an application that allows a user to enter two Strings. Output the number 
of characters in the first String that also appear in the second String, and 
output those characters. Figure 7-20 shows two typical executions. Save the file as 
CountMatches.java. 





re 
fay Command Prompt 


C:\Java>java CountMatches 

Enter a string >> open 

Enter another string >> close 

2 characters in open are also found in close 

The characters in open that are also in close are as follows: 
oe 


C:\Java>java CountMatches 


Enter a string >> puppy 

Enter another string >> pancake 

3 characters in puppy are also found in pancake 

The characters in puppy that are also in pancake are follows: 
ppp 


C:\Java>_ 




















Figure 7-20 Two typical executions of the CountMatches application 


5. Write an application that counts the words in a String entered by a user. Words are 
separated by any combination of spaces, periods, commas, semicolons, question 
marks, exclamation points, or dashes. Figure 7-21 shows two typical executions. Save 
the file as Count Words.java. 
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a 
fay Command Prompt a 





C:\Java>java CountWords 
Enter a string >> Hello. Jane. How are you?? 
There are 5 words in the string 


Cz:\Java>java CountWords 389 
Enter a string >> Today -—- no, wait —- yesterday was Friday? 
There are 6 words in the string 








| (CES EtIE 











Figure 7-21 Two typical executions of the CountWords application 


6. a. Write an application that accepts three Strings from the user and displays one of 
two messages depending on whether the user entered the Strings in alphabetical 
order without regard to case. Save the file as Alphabetize.java. 


b. Write an application that accepts three Strings from the user and displays them 
in alphabetical order without regard to case. Save the file as Alphabetize2.java. 
7. Write an application that demonstrates each of the following methods based on the 


following quote: 


"You can never cross the ocean until you have the courage to lose sight 
of the shore." - Christopher Columbus 


e indexOf('v') 

e indexOf('x') 

e charAt(16) 

e endsWithC"bus") 
e endsWithC"car") 


e replaceC('c', 'C') 













Save the file as DemonstratingStringMethods.java. 


8. Three-letter acronyms are common in the business world. For example, in Java you 
use the IDE (Integrated Development Environment) in the JDK (Java Development 
Kit) to write programs used by the JVM (Java Virtual Machine) that you might send 
over a LAN (local area network). Programmers even use the acronym TLA to stand 
for three-letter acronym. Write a program that allows a user to enter three words, and 
display the appropriate three-letter acronym in all uppercase letters. If the user enters 
more than three words, ignore the extra words. Figure 7-22 shows a typical execution. 
Save the file as ThreeLetterAcronym.java. 
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Please enter three words Original phrase was random access memory 





|random access memory Three letter acronym is RAM 

















390 Cancel 








Figure 7-22 Typical execution of the ThreeLetterAcronym program 


9. Prompt a user to enter a series of integers separated by spaces and accept the 
input as a String. Display the list of integers and their sum. Save the file as 
SumIntegersInString.java. 


10. Write an application that determines whether a phrase entered by the user is a 
palindrome. A palindrome is a phrase that reads the same backward and forward 
without regarding capitalization or punctuation. For example, “Dot saw I was Tod”, 
“Was it a car or a cat I saw?”, and “Madam, I’m Adam” are palindromes. Save the 
file as Palindrome.java. 


11. Write an application that prompts a user for a full name and street address and 
constructs an ID from the user’s initials and numeric part of the address. For example, 
the user William Henry Harrison who lives at 34 Elm would have an ID of WHH34, 
whereas user Addison Mitchell who lives at 1778 Monroe would have an ID of 
AM17738. Save the file as ConstructID.java. 


12. Write an application that accepts a user’s password from the keyboard. When the 
entered password has fewer than six characters, more than 10 characters, or does not 
contain at least one letter and one digit, prompt the user again. When the user’s entry 
meets all the password requirements, prompt the user to reenter the password, and 
do not let the user continue until the second password matches the first one. Save the 
file as Password. java. 


13. Create a TaxReturn class with fields that hold a taxpayer’s Social Security number, last 
name, first name, street address, city, state, zip code, annual income, marital status, 
and tax liability. Include a constructor that requires arguments that provide values for 
all the fields other than the tax liability. The constructor calculates the tax liability 
based on annual income and the percentages in the following table. 








Marital status 








Income ($) Single Married 
0-20,000 15% 14% 
20,001-50,000 22% 20% 
50,001 and over 30% 28% 
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In the TaxReturn class, also include a display method that displays all the TaxReturn 
data. Save the file as TaxReturn.java. 


Create an application that prompts a user for the data needed to create a TaxReturn. 
Continue to prompt the user for data as long as any of the following are true: 


e The Social Security number is not in the correct format, with digits and dashes 391 
in the appropriate positions; for example, 999-99-9999., 








e The zip code is not five digits. 


yo om 


e The marital status does not begin with one of the following: “S”, “s”, “M”, or “m”. 


e The annual income is negative. 


After all the input data is correct, create a TaxReturn object and then display its 
values. Save the file as PrepareTax.java. 


% Debugging Exercises 


1. Each of the following files in the Chapter07 folder of your downloadable 
student files has syntax and/or logic errors. In each case, determine the problem 
and fix the program. After you correct the errors, save each file using the same 
filename preceded with Fix. For example, DebugSeven1.java will become 
FixDebugSeven1l.java. 


a. DebugSevenl.java c. DebugSeven3.java 
b. DebugSeven2.java d. DebugSeven4.java 


ay Game Zone 


1. a. In Chapter 3, you designed a Card class. The class holds fields that contain a 
Card’s value and suit. Currently, the suit is represented by a single character 
(s, h, d, or c). Modify the class so that the suit is a string (“Spades”, “Hearts”, 
“Diamonds”, or “Clubs”). Also, add a new field to the class to hold the string 
representation of a Card’s rank based on its value. Within the Card class 
setValue() method, besides setting the numeric value, also set the string rank 


value as follows. 
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Numeric value String value for rank 
1 “Ace” 
2 through 10 “2” through “10” 
392 11 “Jack” 
12 “Queen” 
13 “King” 


b. In Chapter 5, you created a War Card game that randomly selects two cards (one 
for the player and one for the computer) and declares a winner (or a tie). Modify 
the game to set each Card’s suit as the appropriate string, then execute the game 
using the newly modified Card class. Figure 7-23 shows four typical executions. 
Recall that in this version of War, you assume that the Ace is the lowest-valued 
card. Save the game as War2.java. 








r 
fae Command Prompt =n rox) 


C=\Java>java War2 

My card is the Queen of Clubs 
- card is the Queen of Spades 
s a tie 


Cz\Java>java War2 

My card is the 5 of Spades 
Your card is the 3 of Spades 
I win 


C:\Java>java War2 

My card is the 5 of Clubs 
Your card is the 3 of Clubs 
I win 


Ff Hearts 
fF Diamonds 



















Figure 7-23 Four typical executions of the War2 game 


2. In Chapter 5, you created a Rock Paper Scissors game. In the game, a player entered a 
number to represent one of the three choices. Make the following improvements to 
the game: 


ym 


e Allow the user to enter a string (“rock”, “paper”, or “scissors”) instead of a digit. 


e Make sure the game works correctly whether the player enters a choice in 
uppercase or lowercase letters or a combination of the two. 
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e To allow for player misspellings, accept the player’s entry as long as the first two 
letters are correct. (In other words, if a player types “scixxrs”, you will accept it as 
“scissors” because at least the first two letters are correct.) 


e When the player does not type at least the first two letters of the choice correctly, 
reprompt the player and continue to do so until the player’s entry contains at least 


the first two letters of one of the options. 393 








e Allow 10 complete rounds of the game. At the end, display counts of the number 
of times the player won, the number of times the computer won, and the number 
of tie games. 


Save the file as RockPaperScissors2.java. 


3. Create a simple guessing game, similar to Hangman, in which the user guesses letters 
and then attempts to guess a partially hidden phrase. Display a phrase in which some 
of the letters are replaced by asterisks; for example, “G* T***” (for “Go Team”). Each 
time the user guesses a letter, either place the letter in the correct spot (or spots) in 
the phrase and display it again, or tell the user the guessed letter is not in the phrase. 
Display a congratulatory message when the entire correct phrase has been deduced. 
Save the game as SecretPhrase.java. In the next chapter, you will modify this 
program so that instead of presenting the user with the same phrase every time the 
game is played, the program randomly selects the phrase from a list of phrases. 


4, Eliza is a famous 1966 computer program written by Joseph Weizenbaum. It imitates 
a psychologist (more specifically, a Rogerian therapist) by rephrasing many of a 
patient’s statements as questions and posing them to the patient. This type of therapy 
(sometimes called nondirectional) is often parodied in movies and television shows, in 
which the therapist does not even have to listen to the patient, but gives “canned” 
responses that lead the patient from statement to statement. For example, when the 
patient says, “I am having trouble with my brother,” the therapist might say, “Tell me 
more about your brother.” If the patient says, “I dislike school,” the therapist might 
say, “Why do you say you dislike school?” Eliza became a milestone in the history of 
computers because it was the first time a computer programmer attempted to create 
the illusion of human-to-human interaction. 


Create a simple version of Eliza by allowing the user to enter statements continually 
until the user quits by typing “Goodbye”. After each statement, have the computer 
make one of the following responses: 













e Ifthe user entered the word “my” (for example, “I am having trouble with my 
brother”), respond with “Tell me more about your” and insert the noun in 
question—for example, “Tell me more about your brother”. When you search for 
a word in the user’s entry, make sure it is the entire word and not just letters 
within another word. For example, when searching for my, make sure it is not part 
of another word such as dummy or mystic. 


e Ifthe user entered a strong word, such as “love” or “hate”, respond with, “You 
seem to have strong feelings about that”. 
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e Add a few other appropriate responses of your choosing. 


e In the absence of any of the preceding inputs, respond with a random phrase 
from the following: “Please go on”, “Tell me more”, or “Continue”. 


Save the file as Eliza.java. 
394 





Case Problems 





1. Carly’s Catering provides meals for parties and special events. In previous chapters, 
you have developed a class that holds catering event information and an 
application that tests the methods using four objects of the class. Now modify the 
Event and EventDemo classes as follows: 


e Modify the method that sets the event number in the Event class so that if the 
argument passed to the method is not a four-character String that starts with 
a letter followed by three digits, then the event number is forced to “A000”. If 
the initial letter in the event number is not uppercase, force it to be so. 


e Adda contact phone number field to the Event class. 


e Adda set method for the contact phone number field in the Event class. 
Whether the user enters all digits or any combination of digits, spaces, dashes, 
dots, or parentheses for a phone number, store it as all digits. For example, if 
the user enters (920) 872-9182, store the phone number as 9208729182. If the 
user enters a number with fewer or more than 10 digits, store the number as 
0000000000. 


e Adda get method for the phone number field. The get method returns the 
phone number as a String constructed as follows: parentheses surround a 
three-digit area code, followed by a space, followed by the three-digit phone 
exchange, followed by a hyphen, followed by the last four digits of the phone 
number. 


e Modify the EventDemo program so that besides the event number and guests, 
the program also prompts the user for and retrieves a contact phone number 
for each of the sample objects. Display the phone number along with the other 
Event details. Test the EventDemo application to make sure it works correctly 
with valid and invalid event and phone numbers. 










Save the files as Event.java and EventDemo.java. 


2. Sammy’s Seashore Supplies rents beach equipment to tourists. In previous 
chapters, you have developed a class that holds equipment rental information and 
an application that tests the methods using four objects of the class. Now modify 
the Rental and RentalDemo classes as follows: 


e Modify the method that sets the contract number in the Rental class so that if 
the argument passed to the method is not a four-character String that starts 
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with a letter followed by three digits, then the contract number is forced to 
“A000”. If the initial letter in the contract number is not uppercase, force it 
to be so. 


e Adda contact phone number field to the Rental class. 


e Adda set method for the contact phone number field in the Rental class. 395 
Whether the user enters all digits or any combination of digits, spaces, dashes, 
dots, or parentheses for a phone number, store it as all digits. For example, if the 
user enters (920) 872-9182, store the phone number as 9208729182. If the user 
enters a number with fewer or more than 10 digits, store the number as 
0000000000. 








e Adda get method for the phone number field. The get method returns the phone 
number as a String constructed as follows: parentheses surround a three-digit 
area code, followed by a space, followed by the three-digit phone exchange, 
followed by a hyphen, followed by the last four digits of the phone number. 


e Modify the RentalDemo program so that besides the contract number and 
minutes, the program also prompts the user for and retrieves a contact phone 
number for each of the sample objects. Display the phone number along with the 
other Rental details. Test the RentalDemo application to make sure it works 
correctly with valid and invalid contract and phone numbers. 


Save the files as Rental.java and RentalDemo.java. 
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Arrays 


In this chapter, you will: 


Declare arrays 


(©) 


Initialize an array 


(©) 


Use variable subscripts with an array 
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Search an array and use parallel arrays 
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Pass arrays to and return arrays from methods 
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CHAPTER 8 Arrays 


Declaring Arrays 


While completing the first five chapters in this book, you stored values in variables. In those 

early chapters, you simply stored a value and used it, usually only once, but never more than a 

few times. In Chapter 6, you created loops that allow you to “recycle” variables and use them 
398 many times; that is, after creating a variable, you can assign a value, use the value, and then, 
in successive cycles through the loop, reuse the variable as it holds different values. 





At times, however, you might encounter situations in which storing just one value at a time 
in memory does not meet your needs. For example, a sales manager who supervises 20 
employees might want to determine whether each employee has produced sales above or 
below the average amount. When you enter the first employee’s sales value into an 
application, you can’t determine whether it is above or below average because you don’t 
know the average until you have all 20 values. Unfortunately, if you attempt to assign 

20 sales values to the same variable, when you assign the value for the second employee, 
it replaces the value for the first employee. 


A possible solution is to create 20 separate employee sales variables, each with a unique name, 
so you can store all the sales until you can determine an average. A drawback to this method 
is that if you have 20 different variable names to be assigned values, you need 20 separate 
assignment statements. For 20 different variable names, the statement that calculates total 
sales will be unwieldy, such as: 


total = firstAmt + secondAmt + thirdAmt + ... 
This method might work for 20 salespeople, but what if you have 10,000 salespeople? 


The best solution is to create an array. An array is a named list of data items that all 

have the same type. Each data item is an element of the array. You declare an array variable 
in the same way you declare any simple variable, but you insert a pair of square brackets 
after the type. For example, to declare an array of double values to hold sales figures for 
salespeople, you can write the following: 


double[] salesFigures; 


Similarly, to create an array of integers to hold student ID numbers, you can write the 
following: 


int[{] idNums; 


double salesFigures[];. This format is familiar to C and C++ programmers, but the preferred 
format among Java programmers is to place the brackets following the variable type and before the 
variable name. 


Q In Java, you can also declare an array variable by placing the square brackets after the array name, as in 


You can provide any legal identifier you want for an array, but Java programmers 
conventionally name arrays by following the same rules they use for variables—array 
names start with a lowercase letter and use uppercase letters to begin subsequent words. 
Additionally, many programmers observe one of the following conventions to make it 
more obvious that the name represents a group of items: 
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e Arrays are often named using a plural noun such as salesFigures. 


e Arrays are often named by adding a final word that implies a group, such as salesList, 
salesTable, or salesArray. 


After you create an array variable, you still need to reserve memory space. You use the same 
procedure to create an array that you use to create an object. Recall that when you create a 399 
class named Employee, you can declare an Employee object with a declaration such as: 








Employee oneWorker; 


However, that declaration does not actually create the oneWorker object. You create the 
oneWorker object when you use the keyword new and the constructor method, as in: 


oneWorker = new Employee() ; 


Similarly, declaring an array and reserving memory space for it are two distinct processes. 
To reserve memory locations for 20 salesFigures values, you can declare the array variable 
and create the array with two separate statements as follows: 


double[] salesFigures; 
salesFigures = new double[20]; 


Alternatively, just as with objects, you can declare and create an array in one statement 
with the following: 


double[] salesFigures = new double[20]; 


as it is in some other languages such as C++. Other languages, such as Visual Basic, BASIC, and COBOL, 
use parentheses rather than brackets to refer to individual array elements. By using brackets, the creators 
of Java made it easier for you to distinguish array names from methods. 


Q In Java, the size of an array follows the data type and is never declared immediately following the array name, 


The statement double[] salesFigures = new double[20]; reserves 20 memory locations 
for 20 double values. You can distinguish each salesFigures item from the others with a 
subscript. A subscript is an integer contained within square brackets that specifies one of 
an array’s elements. In Java, any array’s elements are numbered beginning with 0, so you can 
legally use any subscript from 0 through 19 when working with an array that has 20 elements. 
In other words, the first salesFigures array element is salesFigures[0] and the last 
salesFigures element is salesFigures[19]. Figure 8-1 shows how the first few and last 
few elements of an array of 20 salesFigures values appears in computer memory. 





salesFigures[1] salesFigures[18] 


Pe TFT. BST, TT 


salesFigures[0] salesFigures[2] salesFigures[17] salesFigures[19] 





Figure 8-1 The first few and last few elements of an array of 20 salesFigures items in memory 
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issued by the compiler. 


Q A subscript is also called an index. In particular, you will see the term index in some error messages 


It is a common mistake to forget that the first element in an array is element 0, especially 
if you know another programming language in which the first array element is element 1. 
Making this mistake means you will be “off by one” in your use of any array. It is also 
common to forget that the last element’s subscript is one less than the array’s size and 
not the array’s size. For example, the highest allowed subscript for a 100-element array 

is 99. To remember that array elements begin with element 0, it might help if you think 
of the first array element as being “zero elements away from” the beginning of the array, 
the second element as being “one element away from” the beginning of the array, and so on. 
If you use a subscript that is too small (that is, negative) or too large for an array, the 
subscript is out of bounds and an error message is generated. 


When you work with any individual array element, you treat it no differently than you 
would treat a single variable of the same type. For example, to assign a value to the first 
salesFigures element in an array, you use a simple assignment statement, such as the 
following: 


salesFigures[0] = 2100.00; 


To display the last salesFigures element in an array of 20, you can write: 


System.out.printIn(salesFigures[19]); 


When programmers talk about these statements, they typically say things like, “salesFigures 
sub zero is assigned 2100.00,” and “salesFigures sub 19 is output.” In other words, they 
use sub as shorthand for “with the subscript.” 


When you declare or access an array, you can use any expression to represent the size, 
as long as the expression is an integer. For example, to declare a double array named 
moneyValues, you might use any of the following: 


A literal integer constant; for example: 

double[] moneyValues = new double[10]; 

A named integer constant; for example: 

double[] moneyValues = new double[NUMBER_ELS]; 


In this example, the constant NUMBER_ELS must have been declared previously and 
assigned a value. 


An integer variable; for example: 
double[] moneyValues = new double[numberOfE1s] ; 


In this example, the variable numberOfE1s must have been declared previously and 
assigned a value. 
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e A calculation; for example: 
double[] moneyValues = new double[x + y * z]; 


In this example, the variables x, y, and z must have been declared previously and 
assigned values, and the result of the mathematical expression must be an integer. 
401 








e A method’s return value; for example: 
double[] moneyValues = new double[getElementsQ]; 
In this example, the method getElements() must return an integer. 


Some other programming languages, such as C++, allow only named or unnamed constants 
to be used for the size when an array is declared. Java allows variables, arithmetic expressions, 
and method return values, which makes array declaration more flexible. 


Declaring Arrays 
1. The statement int[] idNums = new int[35]; reserves enough memory for 
exactly 34 integers. 


2. The first element in any array has a subscript of 0, no matter what data type is 
stored. 


3. In Java, you can use a variable as well as a constant to declare an array’s size. 
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<n You Do It 


Declaring an Array 


In this section, you create a small array to see how arrays are used. The array holds 
salaries for four categories of employees. 


1. Open a new text file in your text editor. 


2. Begin the class that demonstrates how arrays are used by typing the 
following class and main) headers and their corresponding opening 
curly braces: 


(continues) 
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deemed that any suppressed content does not materially affect the overall lear 


public class DemoArray (continued) 


{ 
public static void main(String[] args) 


{ 


On a new line, declare and create an array that can hold four double values 
by typing the following: 


double[] salaries = new double[4]; 


One by one, assign four values to the four array elements by typing the 
following: 


salaries[0] = 6.25; 
salaries[1] = 6.55; 
salaries[2] = 10.25; 
salaries[3] = 16.85; 


To confirm that the four values have been assigned, display the salaries one 
by one using the following code: 


System.out.printInC"Salaries one by one are:"); 
System.out.printIn(salaries[0]); 
System.out.printIn(salaries[1]) ; 
System.out.printIn(salaries[2]); 
System.out.printIn(salaries[3]); 


Add the two closing curly braces that end the main® method and the 
DemoArray Class. 


Save the program as DemoArray.java. Compile and run the program. The 
program’s output appears in Figure 8-2. 





ff 
8 Command Prompt rox} 
cas 


C:\Java>java Demofrray 
Salaries one by one are: 

















Figure 8-2 Output of the DemoArray application 
(continues) 





). Editorial review has 


(continued) 
Using a Subscript that is Out of Bounds 


In this section, you purposely generate an out-of-bounds error so you can familiarize 
yourself with the error message generated. 403 








1. As the last executable line in the DemoArray.java file, add a new output 
statement that attempts to display a salaries value using a subscript that 
is beyond the range of the array: 


System.out.printIn(salaries[4]); 


2. Save the file, and then compile and execute it. The output looks like Figure 8-3. 
The program runs successfully when the subscript used with the array is 0, 1, 2, 
or 3. However, when the subscript reaches 4, the error in Figure 8-3 is 
generated. The message indicates that an ArrayIndexOutOfBoundsException 
has occurred and that the offending index is 4. 


fi ; . iS 
fy Command Prompt s 7 


C:z\Java>java Demofrray 
Salaries one by one are: 











Exception in thread “main” java.lang.frrayIndexOutOfBoundsException: 4 


at Demofrray.main(Demofrray. java:15)> 


C2\Jdava> 








Figure 8-3 Output of the DemoArray application when a subscript is out of bounds 


In Chapter 12, you will learn more about the term exception and learn new ways to deal with 
exceptions. 


3. Remove the offending statement from the DemoArray class. Save the 
program, and then compile and run it again to confirm that it again 
executes correctly. 


Initializing an Array 


A variable that has a primitive type, such as int, holds a value. A variable with a reference 
type, such as an array, holds a memory address where a value is stored. In other words, array 
names contain references, as do all Java objects. 
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CHAPTER 8 Arrays 


No memory address is assigned when you declare an array using only a data type, brackets, 
and a name. Instead, the array variable name has the special value nu11, which means the 
identifier is not associated with a memory address. For example, when you define someNums 
in the following statement, the value of someNums is nu11: 


404 intl] someNums; 





When you use the keyword new to define an array, the array name acquires an actual 
memory address value. For example, when you define someNums in the following statement, 
a memory address is assigned: 


int[] someNums = new int[10]; 


When you declare int[] someNums = new int[10];, someNums holds an address, but each 
element of someNums has a value of 0 because someNums is an integer array. Each element 
in a double or float array is assigned 0.0. By default, char array elements are assigned 
‘\u0000’, which is the Unicode value for a nu11 character, and boolean array elements 
automatically are assigned the value false. In arrays of objects, including Strings, each 
element is assigned nu11 by default. 


You already know how to assign a different value to a single element of an array, as in: 
someNums[0] = 46; 


You can also assign nondefault values to array elements upon creation. To initialize an array, 
you use an initialization list of values separated by commas and enclosed within curly braces. 
Providing values for all the elements in an array also is called populating an array. 


For example, if you want to create an array named tenMults and store the first six multiples 
of 10 within the array, you can declare tenMults as follows: 


int[] tenMults = {10, 20, 30, 40, 50, 60}; 


Notice the semicolon at the end of the statement. You don’t use a semicolon following a 
method’s closing curly brace, but you do use one following the closing brace of an array 
initialization list. 


When you populate an array upon creation by providing an initialization list, you do not 
give the array a size—the size is assigned based on the number of values you place in the 
initializing list. For example, the tenMults array just defined has a size of 6. Also, when 
you initialize an array, you do not need to use the keyword new; instead, new memory is 
assigned based on the length of the list of provided values. 


In Java, you cannot directly initialize part of an array. For example, you cannot create an 
array of 10 elements and initialize only five; you either must initialize every element or 
none of them. 


@e . 
= Watch the video Arrays. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





Initializing an Array 





1. When you declare intL] idNums = new int[35];, each element of the array 405 
has a value of 0. 





2. When you declare double[] salaries = new double[10];, each element 
of the array has a value of 0.0. 


3. When you declare int[] scores = {100, 90, 80};, the first three elements 
of the array are assigned the values listed, but all the remaining elements are 
assigned 0. 
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<a You Do It 


Initializing an Array 


Next, you alter your DemoArray program to initialize the array of doubles, rather than 
declaring the array and assigning values later. 


1. Open the DemoArray.java file in your text editor. Immediately save the file as 
DemoArray2.java. Change the class name to DemoArray2. Delete the 
statement that declares the array of four doubles named salaries, and then 
replace it with the following initialization statement: 


double[] salaries = {6.25, 6.55, 10.25, 16.85}; 


2. Delete the following four statements that individually assign the values to the 
array: 
salaries[0] = 6.25; salaries[1] = 6.55; salaries[2] = 10.25; 
salaries[3] = 16.85; 
3. Save the file (as DemoArray2.java), compile, and test the application. The 
values that are output are the same as those shown for the DemoArray 
application in Figure 8-2. 
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CHAPTER 8 Arrays 


Using Variable Subscripts with an Array 


If you treat each array element as an individual entity, there isn’t much of an advantage to 
declaring an array over declaring individual primitive type variables, such as those with the 
type int, double, or char. The power of arrays becomes apparent when you begin to use 
406 subscripts that are variables, rather than subscripts that are constant values. 





For example, suppose you declare an array of five integers that holds quiz scores, such as 
the following: 


int[{] scoreArray = {2, 14, 35, 67, 85}; 


You might want to perform the same operation on each array element, such as increasing 
each score by a constant amount. To increase each scoreArray element by three points, 
for example, you can write the following: 


final int INCREASE = 3; 

scoreArray[0] += INCREASE; 
scoreArray[1] += INCREASE; 
scoreArray[2] += INCREASE; 
scoreArray[3] += INCREASE; 
scoreArray[4] += INCREASE; 


With five scoreArray elements, this task is manageable, requiring only five statements. 
However, you can reduce the amount of program code needed by using a variable as the 
subscript. Then, you can use a loop to perform arithmetic on each array element, as in the 
following example: 


final int INCREASE = 3; 
for(sub = 0; sub < 5; ++sub) 
scoreArray[sub] += INCREASE; 


The variable sub is set to 0, and then it is compared to 5. Because the value of sub is 

less than 5, the loop executes and 3 is added to scoreArray[0]. Then, the variable sub is 
incremented and it becomes 1, which is still less than 5, so when the loop executes again, 
scoreArray[1] is increased by 3, and so on. A process that took five statements now takes 
only one. In addition, if the array had 100 elements, the first method of increasing the array 
values by 3 in separate statements would result in 95 additional statements. The only changes 
required using the second method would be to change the array size to 100 by inserting 
additional initial values for the scores, and to change the middle portion of the for statement 
to compare sub to 100 instead of to 5. The loop to increase 100 separate scores by 3 each is: 


for(sub = 0; sub < 100; ++sub) 
scoreArray[sub] += INCREASE; 


When an application contains an array and you want to use every element of the array in 
some task, it is common to perform loops that vary the loop control variable from 0 to one 
less than the size of the array. For example, if you get input values for the elements in the 
array, alter every value in the array, sum all the values in the array, or display every element in 
the array, you need to perform a loop that executes the same number of times as there are 
elements. When there are 10 array elements, the subscript varies from 0 through 9; when 
there are 800 elements, the subscript varies from 0 through 799. Therefore, in an application 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Using Variable Subscripts with an Array 


that includes an array, it is convenient to declare a symbolic constant equal to the size of 
the array and use the symbolic constant as a limiting value in every loop that processes the 
array. That way, if the array size changes in the future, you need to modify only the value 
stored in the symbolic constant, and you do not need to search for and modify the limiting 


value in every loop that processes the array. 
407 








For example, suppose you declare an array and a symbolic constant as follows: 


int[{] scoreArray = {2, 14, 35, 67, 85}; 
final int NUMBER_OF_SCORES = 5; 


Then, the following two loops are identical: 


for(sub = 0; sub < 5; ++sub) 
scoreArray[sub] += INCREASE; 

for(sub = 0; sub < NUMBER_OF_SCORES; ++sub) 
scoreArray[sub] += INCREASE; 


The second format has two advantages. First, by using the symbolic constant, NUMBER_OF_SCORES, 
the reader understands that you are processing every array element for the size of the entire 
array. If you use the number 5, the reader must look back to the array declaration to confirm 
that 5 represents the full size of the array. Second, if the array size changes because you 
remove or add scores, you change the symbolic constant value only once, and all loops that 
use the constant are automatically altered to perform the correct number of repetitions. 


As another option, you can use a field (instance variable) that is automatically assigned a 
value for every array you create; the length field contains the number of elements in the 
array. For example, when you declare an array using either of the following statements, 
the field scoreArray. length is assigned the value 5: 


int[] scoreArray = {2, 14, 35, 67, 85}; 
int[] scoreArray = new int[5]; 


Therefore, you can use the following loop to add 3 to every array element: 


for(sub = 0; sub < scoreArray.length; ++sub) 
scoreArray[sub] += INCREASE; 


Later, if you modify the size of the array and recompile the program, the value in the length 
field of the array changes appropriately. When you work with array elements, it is always better 
to use a symbolic constant or the length field when writing a loop that manipulates an array. 


A frequent programmer error is to attempt to use length as an array method, referring to 
scoreArray. length(). However, length is not an array method; it is a field. An instance 
variable or object field such as length is also called a property of the object. 


In Chapter 6, you learned to use the for loop. Java also supports an enhanced for loop. 
This loop allows you to cycle through an array without specifying the starting and ending 
points for the loop control variable. For example, you can use either of the following 
statements to display every element in an array named scoreArray: 


for(int sub = 0; sub < scoreArray. length; ++sub) 
System.out.printInCscoreArray[sub]) ; 

for(int val : scoreArray) 
System.out.printIn(val); 
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CHAPTER 8 Arrays 


In the second example, val is defined to be the same type as the array named following 
the colon. Within the loop, val takes on, in turn, each value in the array. You can read the 
second example as, “For each val in scoreArray, display val.” As a matter of fact, you will 
see the enhanced for loop referred to as a foreach loop. 


You also can use the enhanced for loop with more complicated Java objects, as you will see 


408 . . 
in the next section. 





Using Part of an Array 


Sometimes, you do not want to use every value in an array. For example, suppose that you 
write a program that allows a student to enter up to 10 quiz scores and then computes and 
displays the average. To allow for 10 quiz scores, you create an array that can hold 10 values, 
but because the student might enter fewer than 10 values, you might use only part of the 
array. Figure 8-4 shows such a program. 


import java.util.*; 
public class FlexibleQuizAverage 
{ 
public static void main(String[] args) 
{ 
int[] scores = new int[10]; 
int score = 0; 
int count 0; 
int total = 0; 
final int QUIT = 999; 
final int MAX = 10; 
Scanner input = new Scanner(System. in); 
System.out.printC"Enter quiz score >> "); 
score = input.nextintQ; 
whileCcount < MAX && score != QUIT) 
{ 


if(score != QUIT) 
{ 


scores[count] = score; 
total += scores[count]; 
System.out.printC"Enter next quiz score or " + 
QUIT + " to quit >> "); 
score = input.nextIntQ; 
} 
count++; 
} 
System.out.printIn("The scores entered were:"); 
forCint x = 0; x < count; ++x) 
System.out.print(scores[x] +" "); 
System.out.printIn("\n The average is " + (total * 1.0 / count)); 





Figure 8-4 The FlexibleQuizAverage application 
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Using Variable Subscripts with an Array 


The FlexibleQuizAverage program declares an array that can hold 10 quiz scores. The 
user is prompted for a first quiz score; then, in the while loop that starts with the first 
shaded line in Figure 8-4, the score is placed in the scores array. Then the score is added 
to a running total, and the user is prompted to enter another quiz score or a QUIT value of 
999 to stop. The while loop continuously checks to ensure that no more than 10 scores 
have been entered and that the user has not entered 999 to quit. After each score entry, 409 
the variable count is incremented, which serves two purposes: It indicates the element 

where the next score should be stored, and when the loop eventually ends, count holds the 

number of scores entered. The variable count then can be used to control the output loop 

(in the shaded for statement) and to help calculate the average score. Figure 8-5 shows a 

typical execution of the program. 











r 
Ge Command Prompt ahaa) | 


C= \dJava>java FlexibleQuizfAverage 


re or 999 to quit 
e or 999 to quit 
quit 
Zz score or 399 to quit 
The scores entered were: 
86 96 82 72 
The average is 81.68 


C2\Java> 

















Figure 8-5 Typical execution of the Flexib1]eQuizAverage application 





Using Variable Subscripts with an Array 


1. When an application contains an array, it is common to perform loops that 
vary the loop control variable from O to one less than the size of the 
array. 


2. Anarray’s length field contains the highest value that can be used as the 
array’s subscript. 


3. The enhanced for loop allows you to cycle through an array 
without specifying the starting and ending points for the loop control 
variable. 
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CHAPTER 8 Arrays 


«a You Do It 


Using a for Loop to Access Array Elements 
410 





Next, you modify the DemoArray2 program to use a for loop with the array. 


1. Open the DemoArray2.java file in your text editor. Immediately save the file 
as DemoArray3.java. Change the class name to DemoArray3. Delete the 
four printIn® statements that display the four array values, and then 
replace them with the following for loop: 


forCint x = 0; x < salaries.length; ++x) 
System.out.printIn(salaries[x]); 


2. Save the program (as DemoArray3.java), compile, and run the program. 
Again, the output is the same as that shown in Figure 8-2. 


Declaring and Using Arrays of Objects 


Just as you can declare arrays of ints or doubles, you can declare arrays that hold elements of 
any type, including objects. For example, assume you create the Employee class shown in 
Figure 8-6. This class has two data fields (empNum and empSa1), a constructor, and a get 
method for each field. 


public class Employee 
{ 
private int empNum; 
private double empSal; 
EmployeeCint e, double s) 
{ 
empNum = e; 
empSal = s; 


} 


public int getEmpNum() 
{ 


return empNum; 


} 
public double getSalary() 


{ 
} 


return empSal; 





Figure 8-6 The Employee class 
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Declaring and Using Arrays of Objects) 


You can create separate Employee objects with unique names, such as either of the following: 


Employee painter, electrician, plumber; 
Employee firstEmployee, secondEmployee, thirdEmployee; 


However, in many programs it is far more convenient to create an array of Employee 
objects. An array named emps that holds seven Employee objects can be defined as: All 








Employee[] emps = new Employee[7]; 


This statement reserves enough computer memory for seven Employee objects named emps [0] 
through emps[6]. However, the statement does not actually construct those Employee objects; 
instead, you must call the seven individual constructors. According to the class definition shown 
in Figure 8-6, the Employee constructor requires two arguments: an employee number and a 
salary. If you want to number your Employees 101, 102, 103, and so on, and start each Employee 
at a salary of $6.35, the loop that constructs seven Employee objects is as follows: 


final int START_NUM = 101; 
final double PAYRATE = 6.35; 
for(int x = 0; x < emps.length; ++x) 
emps[x] = new Employee(START_NUM + x, PAYRATE); 


As x varies from 0 through 6, each of the seven emps objects is constructed with an employee 
number that is 101 more than x, and each of the seven emps objects holds the same salary 
of $6.35, as assigned in the constant PAYRATE. 


Unlike the Employee class in Figure 8-6, which contains a constructor that requires 
arguments, some classes contain only a default constructor, which might be supplied 
automatically when no other constructors are created or might be written explicitly. To 
construct an array of objects using a default constructor, you must still call the constructor 
using the keyword new for each declared array element. For example, suppose you have 
created a class named InventoryItem but have not written a constructor. To create an 
array of 1,000 InventoryItem objects, you would write the following: 


final int NUM_ITEMS = 1000; 
InventoryItem[] items = new InventoryItem[NUM_ITEMS] ; 
for(int x = 0; x < NUM_ITEMS; ++x) 

items[x] = new InventoryItemQ; 


To use a method that belongs to an object that is part of an array, you insert the appropriate 
subscript notation after the array name and before the dot that precedes the method name. 
For example, to display data for seven Employees stored in the emps array, you can write 
the following: 


for(int x = 0; x < emps.length; ++x) 
System.out.printin Cemps[x].getEmpNum() + " " + 
emps[x].getSalaryQ); 


Pay attention to the syntax of the Employee objects’ method calls, such as emps[x] . getEmpNum(). 
Although you might be tempted to place the subscript at the end of the expression 

after the method name—as in emps.getEmpNum[x] or emps.getEmpNum() [x]—you cannot; 
the values in x (0 through 6) refer to a particular emps object, each of which has access 

to a single getEmpNum() method. Placement of the bracketed subscript so it follows emps 
means the method “belongs” to a particular element of emps. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 





CHAPTER 8 Arrays 


Using the Enhanced for Loop with Objects 


You can use the enhanced for loop to cycle through an array of objects. For example, to 
display data for seven Employees stored in the emps array, you can write the following: 


for(Employee worker : emps) 
412 System.out.printIn(worker.getEmpNum() + 


+ worker.getSalary()); 





In this loop, worker is a local variable that represents each element of emps in turn. Using 
the enhanced for loop eliminates the need to use a limiting value for the loop and eliminates 
the need for a subscript following each element. 


Manipulating Arrays of Strings 


As with any other object, you can create an array of String objects. For example, you can 
store three company department names as follows: 


String[] deptNames = {"Accounting", "Human Resources", "Sales"}; 


You can access these department names like any other array object. For example, you can 
use the following code to display the list of Strings stored in the deptNames array: 


for(int a = 0; a < deptNames. length; ++a) 
System.out.println(deptNames[a]) ; 


Notice that deptNames. length; refers to the length of the array deptNames (three elements) 
and not to the length of any String objects stored in the deptNames array. Arrays use a 
length field (no parentheses follow). Each String object has access to a length() method 
that returns the length of a String. For example, if deptNames[0] is “Accounting”, then 
deptNames[0].length() is 10 because “Accounting” contains 10 characters. 





Declaring and Using Arrays of Objects 


1. The following statement declares an array named students that holds 10 
Student objects: 


Student[] students = new Student[10]; 


2. When aclass has a default constructor and you create an array of objects from 
the class, you do not need to call the constructor explicitly. 


3. Touse a method that belongs to an object that is part of an array, you insert the 
appropriate subscript notation after the array name and before the dot that 
precedes the method name. 
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iN You Do It 


Creating a Class That Contains an Array of Strings 
413 








In this section, you create a class named BowlingTeam that contains the name of 
a bowling team and an array that holds the names of the four team members. 


1. Open a new file in your text editor, and type the header and curly braces 
for the BowlingTeam Class: 


public class Bowl ingTeam 
{ 
} 


2. Create a field for the team name and an array that holds the team 
members’ names. 


private String teamName; 
private String[] members = new String[4]; 


3. Create get and set methods for the teamName field as follows: 


public void setTeamName(String team) 
{ 
teamName = team; 
} 
public String getTeamName() 


{ 


} 


4. Adda method that sets a team member’s name. The method requires 
a position and a name, and it uses the position as a subscript to the 
members alray. 


return teamName; 


public void setMember(int number, String name) 


{ 


members[number] = name; 
} 
5. Adda method that returns a team member’s name. The method requires a 
value used as the subscript that determines which member’s name to return. 


public String getMember(int number) 
{ 


return members[number]; 


} 
6. Save the file as BowlingTeam.java. Compile it and correct any errors. 


(continues) 
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CHAPTER 8 Arrays 


(continued) 
Creating a Program to Demonstrate an Instance of the BowlingTeam Class 


In this section, you write a program in which you create an instance of the BowlingTeam 
414 class and provide values for it. 





1. Open a new file in your text editor, and enter the following code to begin 
the class. 


public class Bowl ingTleamDemo 


{ 


public static void main(String[] args) 


{ 


2. Add five declarations. These include a String that holds user input, a 
BowlingTeam object, an integer to use as a subscript, a constant that 
represents the number of members on a bowling team, and a Scanner 
object for input. 


String name; 

BowlingTeam bowlTeam = new Bowl ingTeam() ; 
int x; 

final int NUM_TEAM_ MEMBERS = 4; 

Scanner input = new Scanner(System. in); 


3. Prompt the user for a bowling team name. Accept it, and then assign it to 
the BowlingTeam object: 


System.out.print("Enter team name >> "); 
name = input.nextLineQ) ; 
bow] Team. setTeamName (name) ; 


4. I|na loop that executes four times, prompt the user for a team member’s 
name. Accept the name and assign it to the BowlingTeam object using the 
subscript to indicate the team member’s position in the array in the 
BowlingTeam class. 


for(x = 0; x < NUM_TEAM_MEMBERS; ++x) 

{ 
System.out.printC"Enter team member's name >> "); 
name = input.nextLineQ); 
bowl Team. setMember(x, name); 


} 
5. Display the details of the BowlingTeam object using the following code: 


System.out.printInC"\nMembers of team " + 
bowl Team. getTeamName()) ; 
for(x = 0; x < NUM_TEAM_MEMBERS; ++x) 
System.out.print(bow]lTeam.getMember(x) +" "); 
System.out.printinQ; 


(continues) 
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Declaring and Using Arrays of Objects) 


(continued) 


6. Add a closing curly brace for the main® method and another for the class. 


7. Save the file as BowlingTeamDemo.java, and then compile and execute it. 


Figure 8-7 shows a typical execution. 415 











( C= Le) 
C d Prompt roy x=) 
fay Command Promp 


C:\Java>java BowlingTeamDemo 
name >> The Lucky Strikes 
member’s name >> Vic 
member’s name >> Nick 
member’s name >> Stan 
member’s name >> Bill 


, 


team The Lucky Strikes 
Stan Bill 














Figure 8-7 Typical execution of the Bowl ingTeamDemo class 


Creating a Program That Declares an Array of BowlingTeam Objects 
Next, you create and use an array of BowlingTeam objects. 


1. Open the BowlingTeamDemo.java file. Rename the class BowlingTeamDemo2, 
and immediately save the file as BowlingTeamDemo2.java. 


2. Above the declaration of the BowlingTeam object, add a new named constant 
that holds a number of BowlingTeams, and then replace the statement that 
declares the single BowlingTeam object with an array declaration of four 
BowlingTeam objects. 


final int NUM_TEAMS 
BowlingTeam[] teams 


4; 
new Bowl ingTeam[NUM_TEAMS]; 


3. The current program declares x, which is used as a subscript to display 
team member names. Now, following the declaration of x, add a variable 
that is used as a subscript to display the teams: 
int y; 


4. Following the declaration of the Scanner object, and before the team 
name prompt, insert a for loop that executes as many times as there 


(continues) 
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(continued) 
are BowlingTeams. Add the opening curly brace, and within the loop, 
allocate memory for each array element: 


for(y = 0; < NUM_TEAMS; ++y) 
416 { . ‘ : 





teams[y] = new BowlingTeamQ) ; 


5. Delete the statement that uses the setTeamName() method with the single 
bowlTeam object. In its place, insert a statement that uses the method with 
one of the array elements: 


teams[y] .setTeamName (name) ; 


6. Within the first for loop controlled by x, delete the statement that uses the 
setMember() method with the single bow1Team object. In its place, insert a 
statement that uses the method with one of the array elements: 


teams[y] .setMember(x, name) ; 
7. Adda closing curly brace for the for loop controlled by the variable y. 


8. Adjust the indentation of the program statements so that the program logic 
is easy to follow with the new nested loops. The nested loops that you just 
modified should look like the following 13 lines of code: 


for(y = 0; y < NUM_TEAMS; ++y) 
{ 

teams[y] = new Bowl ingTeam() ;sx 

System.out.printC"Enter team name >> "); 

name = input.nextLineQ ; 

teams[y] .setTeamName (name) ; 

for(x = 0; x < NUM_TEAM_MEMBERS; ++x) 

{ 
System.out.printC"Enter team member's name >> "); 
name = input.nextLineQ) ; 
teams[y].setMember(x, name) ; 


} 


9. The for loop at the end of the current program lists four team members’ 
names. Replace this loop with the following nested version that lists four 
members’ names for each of four teams: 


for(y = 0; y < NUM_TEAMS; ++y) 


{ 
System.out.printIn("\nMembers of team " + 
teams[y] .getTeamNameQ)) ; 
for(x = 0; x < NUM_TEAM_MEMBERS; ++x) 
System.out.print(teams[y].getMember(x) +" "); 
System.out.printinQ; 
} 


(continues) 
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(continued) 


10. Save the file, and then compile and execute the program. Figure 8-8 shows a 
typical execution. The user can enter data into the array of BowlingTeam objects, 
including the array of Strings within each object, and then see all the entered 417 
data successfully displayed. 











i 


fay Command Prompt 


C:\Java>java BowlingTeamDemo2 
team name >> The Lucky Strikes 
team member’ name >> Vic 
team member’s name >> Nick 
team member’s name >> Stan 
team member’ name >> Bill 
team name >> The Tigers 
team member’s name >> Allison 
team member’s name >> Jennie 
team member’s name >> Pam 
team member’ name >> Kim 
team name >> The Alley Cats 
team member’s name >> Sam 
team member’ name >> Lois 
team member’s name >> Zach 
team member’ name >> Julia 
team name >> Spare Parts 
member’s name >> Jim 
member’ name >> Tom 
member’s name >> Julie 
member name >> Kate 


“nanan 


“nnn 


“nnn 


team Lucky Strikes 
Stan i 


Members of team The Tigers 
Allison Jennie Pam Kim 


Members of team The Alley Cats 
Lois Zach Julia 


of team Spare Parts 
Julie Kate 








Figure 8-8 Typical execution of the BowlingTeamDemo2 application 
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CHAPTER 8 Arrays 


Searching an Array and Using Parallel Arrays 


Suppose that a company manufactures 10 items. When a customer places an order for an 

item, you need to determine whether the item number on the order form is valid. When you 

want to determine whether a variable holds one of many valid values, one option is to use 
418 a series of if statements to compare the variable to a series of valid values. If valid item 
numbers are sequential, such as 101 through 110, the following simple if statement that 
uses a logical AND can verify the order number and set a Boolean field to true: 





final int LOW = 101; 

final int HIGH = 110; 

boolean validitem = false; 

ifCitemOrdered >= LOW && itemOrdered <= HIGH) 
validItem = true; 


If the valid item numbers are nonsequential—for example, 101, 108, 201, 213, 266, 304, and 
so on—you can code the following deeply nested if statement or a lengthy OR comparison 
to determine the validity of an item number: 


ifCitemOrdered == 101) 
validItem = true; 

else if(itemOrdered == 108) 
validItem = true; 

else if(itemOrdered == 201) 
validItem = true; 

// and so on 


Instead of a long series of if statements, a more elegant solution is to compare the 
itemOrdered variable to a list of values in an array, a process called searching an array. 
You can initialize the array with the valid values using the following statement, which 
creates exactly 10 array elements with subscripts 0 through 9: 


int[] validValues = {101, 108, 201, 213, 266, 
304, 311, 409, 411, 412}; 


After the list of valid values is initialized, you can use a for statement to loop through 
the array, and set a Boolean variable to true when a match is found: 


for(int x = 0; x < validValues.length; ++x) 
{ 
ifCitemOrdered == validValues[x]) 
validItem = true; 


} 


This simple for loop replaces the long series of if statements; it checks the itemOrdered value 
against each of the 10 array values in turn. Also, if a company carries 1,000 items instead of 10, 
nothing changes in the for statement—the value of validValues. length is updated automatically. 


Using Parallel Arrays 


As an added bonus, if you set up another array with the same number of elements and 
corresponding data, you can use the same subscript to access additional information. 
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Searching an Array and Using Parallel Arrays D0 


A parallel array is one with the same number of elements as another and for which the 
values in corresponding elements are related. For example, if the 10 items your company 
carries have 10 different prices, you can set up an array to hold those prices as follows: 


double[] prices = {0.29, 1.23, 3.50, 0.69..}; 


The prices must appear in the same order as their corresponding item numbers in the 419 
validValues array. Now, the same for loop that finds the valid item number also finds 
the price, as shown in the application in Figure 8-9. In the shaded portion of the code, 
notice that when the ordered item’s number is found in the validValues array, the 
itemPrice value is “pulled” from the prices array. In other words, if the item number is 
found in the second position in the validValues array, you can find the correct price in 
the second position in the prices array. Figure 8-10 shows a typical execution of the 
program. A user requests item 409, which is the eighth element in the validValues array, 
so the price displayed is the eighth element in the prices array. 








import javax.swing.*; 
public class FindPrice 
{ 
public static void main(String[] args) 
{ 
final int NUMBER_OF_ITEMS = 10; 
int{] validValues = {101, 108, 201, 213, 266, 
304, 311, 409, 411, 412}; 
double[] prices = {0.29, 1.23, 3.50, 0.69, 6.79, 
3.19, 0.99, 0.89, 1.26, 8.00}; 
String stritem; 
int itemOrdered; 
double itemPrice = 0.0; 
boolean validItem = false; 
strItem = JOptionPane.showInputDialog(null, 
"Enter the item number you want to order"); 
itemOrdered = Integer.parseInt(stritem) ; 
forCint x = 0; x < NUMBER_OF_ITEMS; ++x) 
{ 


ifCitemOrdered == validValues[x]) 


validItem = true; 
itemPrice = prices[x]; 
} 
} 
if(validItem) 
JOptionPane.showMessageDialog(null, "The price for item " + 
jtemOrdered + " is $" + itemPrice); 
else 


JOptionPane.showMessageDialog(null, 
"Sorry - invalid item entered"); 





Figure 8-9 The FindPrice application that accesses information in parallel arrays 
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Enter the item number you want to order 
|409 





@ The price for item 409 is $0.89 





420 








Figure 8-10 Typical execution of the FindPrice application 


When you initialize parallel arrays, it is convenient to use spacing so that the values that correspond to 
Y each other visually align on the screen or printed page. 


Item in which each instance contains two fields—itemOrdered and itemPrice. Then you could 
create a single array of objects that encapsulate item numbers and prices. There are almost always 
multiple ways to approach programming problems. 


Q Instead of parallel arrays containing item numbers and prices, you might prefer to create a class named 


Within the code shown in Figure 8-9, you compare every itemOrdered with each of the 

10 validValues. Even when an itemOrdered is equivalent to the first value in the 
validValues array (101), you always make nine additional cycles through the array. On each 
of these nine additional cycles, the comparison between itemOrdered and validValues[x] is 
always false. As soon as a match for an itemOrdered is found, it is most efficient to break 
out of the for loop early. An easy way to accomplish this is to set x to a high value within 
the block of statements executed when there is a match. Then, after a match, the for loop 
does not execute again because the limiting comparison (x < NUMBER_OF_ITEMS) is surpassed. 
Figure 8-11 shows this loop. In an array with many possible matches, it is most efficient 

to place the more common items first, so they are matched right away. For example, if 
item 311 is ordered most often, place 311 first in the validValues array, and place its 

price ($0.99) first in the prices array. 


forCint x = 0; x < NUMBER_OF_ITEMS; ++x) 


{ 
ifCitemOrdered == validValues[x]) 


{ 


validItem = true; 
itemPrice = prices[x]; 
x = NUMBER_OF_ITEMS; 


} 





Figure 8-11 A for loop with an early exit 
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In the code in Figure 8-11, the loop control variable is altered within the loop body. 
Some programmers object to altering a loop control variable within the body of a for loop; 
they feel that the loop control variable should be altered only in the third section of the for 
clause (where x is incremented). These programmers would prefer the loop in Figure 8-12, 
in which two Boolean expressions appear in the shaded section in the middle portion of 
the for clause. In this example, the loop control variable is not altered within the loop 421 
body. Instead, x must be within range before each iteration and validItem must not yet 

have been set to true. 








forCint x = 0; x < NUMBER_OF_ITEMS && !validItem; ++x) 


{ 
ifCitemOrdered == validValues[x]) 
{ 


validItem = true; 
itemPrice = prices[x]; 





Figure 8-12 A for loop that uses a compound test for termination 


Searching an Array for a Range Match 


Searching an array for an exact match is not always practical. Suppose your company gives 
customer discounts based on the quantity of items ordered. Perhaps no discount is given 
for any order of fewer than a dozen items, but there are increasing discounts available for 
orders of increasing quantities, as shown in Table 8-1. 





Total Quantity Ordered Discount 
1 to 12 None 
13 to 49 10% 
50 to 99 14% 
100 to 199 18% 
200 or more 20% 


Wel) Ee:S) Discount table 


One awkward programming option is to create a single array to store the discount rates. 
You could use a variable named numOfItems as a subscript to the array, but the array 
would need hundreds of entries, as in the following example: 


double[] discounts = {0, 0, 0, 0, 0, 0, 0, O, 
0, 0, 0, 0, 0, 0.10, 0.10, 0.10 ...}; 
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Thirteen zeroes are listed in the discounts array. The first array element has a 0 subscript 
and represents a zero discount for zero items. The next 12 discounts (for items 1 through 12) 
are also zero. When numOfItems is 13, discounts [numOfItems], or discounts[13], is 0.10. 
The array would store 37 copies of 0.10 for elements 13 through 49. The discounts array 
would need to be ridiculously large to hold an exact value for each possible quantity ordered. 
422 





A better option is to create two corresponding arrays and perform a range match, in which 
you compare a value to the endpoints of numerical ranges to find the category in which a 
value belongs. For example, one array can hold the five discount rates, and the other array 
can hold five discount range limits. The Total Quantity Ordered column in Table 8-1 
shows five ranges. If you use only the first figure in each range, you can create an array 
that holds five low limits: 


int[] discountRangeLimits = {1, 13, 50, 100, 200}; 
A parallel array can hold the five discount rates: 
double[] discountRates = {0, 0.10, 0.14, 0.18, 0.20}; 


Then, starting at the last discountRangeLimits array element, for any numOfItems greater 
than or equal to discountRangeLimits[4], the appropriate discount is discounts[4]. In 
other words, for any numOrdered less than discountRangeLimits[4], you should decrement 
the subscript and look in a lower range. Figure 8-13 shows an application that uses the parallel 
arrays, and Figure 8-14 shows a typical execution of the program. 


import javax.swing.*; 
public class FindDiscount 
{ 
public static void main(String[] args) 
{ 
final int NUM_RANGES = 5; 
int[] discountRangeLimits = { 1, 13, 50, 100, 200}; 
double[] discountRates = {0.00, 0.10, 0.14, 0.18, 0.20}; 
double customerDiscount; 
String strNumOrdered; 
int numOrdered; 
int sub = NUM_RANGES - 1; 
strNumOrdered = JOptionPane.showInputDialog(null, 
"How many items are ordered?"); 
numOrdered = Integer.parseInt(strNumOrdered) ; 
whileCsub >= 0 && numOrdered < discountRangeLimits[sub]) 
--sub; 
customerDiscount = discountRates[sub]; 
JOptionPane.showMessageDialog(null, "Discount rate for " + 
numOrdered + " items is + customerDiscount) ; 





Figure 8-13. The FindDiscount class 
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Message 





@ Discount rate for 54 items is 0.14 





423 








Figure 8-14 Typical execution of the FindDiscount class 


the second half of the statement that compares numOrdered to discountRangeLimits [sub] 
executes. It is a good programming practice to ensure that a subscript to an array does not fall below zero, 
causing a runtime error. 


Q In the whi Te loop in the application in Figure 8-13, sub is required to be greater than or equal to 0 before 


eu Watch the video Searching an Array. 





Searching an Array and Using Parallel Arrays 


1. A parallel array is one with the same number of elements as another and for 
which the values in corresponding elements are related. 


2. When searching an array, it is usually most efficient to abandon the search 
as soon as the sought-after element is found. 


3. Inarange match, you commonly compare a value to the midpoint of each of 
a series of numerical ranges. 
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an" ‘ You Do It 


Searching an Array 


In this section, you modify the BowlingTeamDemo2 program so that after the 
bowling team data has been entered, a user can request the roster for a 
specific team. 


i 


2: 


Open the BowlingTeamDemo2.java file, and change the class name to 
Bow] ingTeamDemo3. Immediately save the file as BowlingTeamDemo3.java. 


At the end of the existing application, just before the two final closing 
curly braces, insert a prompt asking the user to enter a team name. 
Then accept the entered value. 
System.out.print("\n\nEnter a team name to see its roster >> "); 
name = input.nextLineQ; 
Next, insert a nested for loop. The outer loop varies y from O through 
the highest subscript allowed in the teams array. Within this loop, the 
team name requested by the user is compared to each stored team 
name; when they are equal, another for loop displays the four team 
member names. 
for(y = 0; y < teams.length; ++y) 

if (name. equals (teams [y] . getTeamName())) 


for(x = 0; x < NUM_TEAM MEMBERS; ++x) 
System.out.print(teams[y].getMember(x) + " "); 


Insert an additional empty printIn© method call. 
System.out.printinQ; 


Save the file, and then compile and execute the program. Figure 8-15 shows 
the last part of a typical execution. 


(continues) 
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(continued) 





f 
fe Command Prompt Sox | 


Members of team The Lucky Strikes 425 
Nic Nick Stan Bill 








Members of team The Tigers 
Allison Jennie Pam Kim 


Members of team The Alley Cats 
Sam Lois Zach Julia 


Members of team Spare Parts 
Jim Tom Julie Kate 


Enter a team name to see its roster >> The Alley Cats 
Sam Lois Zach Julia 


Cz\Java>_ 














Figure 8-15 Typical execution of the BowlingTeamDemo3 application 


Passing Arrays to and Returning Arrays from Methods 


You have already seen that you can use any individual array element in the same manner 
as you use any single variable of the same type. That is, if you declare an integer array 
as int[] someNums = new int[12];, you can subsequently display someNums [0], or 
increment someNums[1], or work with any element just as you do for any integer. 
Similarly, you can pass a single array element to a method in exactly the same manner 
as you pass a variable. 


Examine the PassArrayElement application shown in Figure 8-16 and the output shown 
in Figure 8-17. The application creates an array of four integers and displays them. 
Then, the application calls the methodGetsOneInt() method four times, passing each 
element in turn. The method displays the number, changes the number to 999, and then 
displays the number again. Finally, back in the main() method, the four numbers are 
displayed again. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learni perience. Ce Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 8 Arrays 





public class PassArrayElement 
{ 
public static void main(String[] args) 
{ 
final int NUM_ELEMENTS = 4; 
426 int[] someNums = {5, 10, 15, 20}; 
int x; 
System.out.printC"At start of main: "); 
for(x = 0; x < NUM_ELEMENTS; ++x) 
System.out.print¢(" " + someNums[x] ); 
System.out.printInQ; 
for(x = 0; x < NUM_ELEMENTS; ++x) 
methodGetsOneInt(someNums [x]); 
System.out.printC"At end of main: "); 
for(x = 0; x < NUM_ELEMENTS; ++x) 
System.out.print¢C" " + someNums[x]); 
System.out.printInQ; 








} 


public static void methodGetsOneInt(Cint one) 
{ 

System.out.printC"At start of method one is: " + one); 
one = 999; 


System.out.printIn(" and at end of method one is: " + one); | 








Figure 8-16 The PassArrayElement class 





fa 
Command P 






java PassfrrayElement 
of main: 5 16 15 26 
tart of method > i 5 and at end of method one 999 
tart of method i 16 and at end of method or i 
t of method o i 15 and at end of method one 
E t of method 26 and at end of method one 
> end of main: 5 1615 26 


C:\Java> 

















Figure 8-17 Output of the PassArrayElement application 


As you can see in Figure 8-17, the four numbers that were changed in the methodGetsOneInt() 
method remain unchanged back in main( after the method executes. The variable named 
one is local to the methodGetsOneInt() method, and any changes to variables passed into 
the method are not permanent and are not reflected in the array in the mainQ) program. 
Each variable named one in the methodGetsOneInt() method holds only a copy of the 
array element passed into the method. The individual array elements are passed by value; 
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that is, a copy of the value is made and used within the receiving method. When any 
primitive type (boolean, char, byte, short, int, long, float, or double) is passed to a 
method, the value is passed. 


Arrays, like all nonprimitive objects, are reference types; this means that the object actually 
holds a memory address where the values are stored. Because an array name is a reference, 
you cannot assign another array to it using the = operator, nor can you compare two arrays 
using the == operator. Additionally, when you pass an array (that is, pass its name) to a 
method, the receiving method gets a copy of the array’s actual memory address. This means 
that the receiving method has access to, and the ability to alter, the original values in the array 
elements in the calling method. 


427 








The class shown in Figure 8-18 creates an array of four integers. After the integers are 
displayed, the array name (its address) is passed to a method named methodGetsArray(). 
Within the method, the numbers are displayed, which shows that they retain their 
values from main(), but then the value 888 is assigned to each number. Even though 
methodGetsArray() is a void method—meaning nothing is returned to the main() 
method—when the main© method displays the array for the second time, all of the 
values have been changed to 888, as you can see in the output in Figure 8-19. Because 
the method receives a reference to the array, the methodGetsArray() method “knows” 
the address of the array declared in main() and makes its changes directly to the 

original array. 


memory address. It is a subtle distinction, but in Java, the receiving method gets a copy of the original 
address. In other words, in Java, an array is not passed by reference, but a reference to an array is 
passed by value. 


Q In some languages, arrays are passed by reference, meaning that a receiving method gets the 


public class PassArray 
{ 
public static void main(String[] args) 
{ 
final int NUM_ELEMENTS = 4; 
int[] someNums = {5, 10, 15, 20}; 
int x; 
System.out.printC"At start of main: "); 
for(x = 0; x < NUM_ELEMENTS; ++x) 
" "+ someNums[x] ); 


System. out.print( 
System.out.printInQd; 
methodGetsArray(someNums) ; 
System.out.printC"At end of main: "); 
for(x = 0; x < NUM_ELEMENTS; ++x) 


System.out.print( + someNums[x]); 


System.out.printInQ; 





Figure 8-18 The PassArray class (continues) 
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(continued) 
public static void methodGetsArray(int[{] arr) 
{ 
int x; 
System.out.printC"At start of method arr holds: "); 
428 for(x = 0; x < arr.length; ++x) 
System.out.print¢C" " + arr[x] ); 
System.out.printInQ; 
for(x = 0; x < arr.length; ++x) 
arr[x] = 888; 
System.out.print(" and at end of method arr holds: "); 
for(x = 0; x < arr.length; ++x) 
System.out.print¢C" " + arr[x] ); 
System.out.printInQ; 
} 
} 

















Figure 8-18 The PassArray class 


Notice that in the first shaded statement in Figure 8-18, the array name is passed to the 
method and no brackets are used. In the method header, brackets are used to show that 
the parameter is an array of integers (a reference) and not a simple int. 





At start of method arr holds: 5 16 15 26 
and at end of method arr holds: 888 888 888 888 
of main: 888 888 888 888 


C:z\Java> 














Figure 8-19 Output of the PassArray application 


In some other languages, notably C, C++, and C#, you can choose to pass variables to methods by value 
or reference. In Java, you cannot make this choice. Primitive type variables are always passed by value. 
When you pass an object, a copy of the reference to the object is always passed. 
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Returning an Array from a Method 


A method can return an array reference. When a method returns an array reference, you 
include square brackets with the return type in the method header. For example, Figure 8-20 
shows a getArray() method that returns a locally declared array of ints. Square brackets 
are used as part of the return type; the return statement returns the array name without any 429 
brackets. 








public static int[] getArrayO 
{ 


int[] scores = {90, 80, 70, 60}; 


return scores; 





Figure 8-20 The getArray() method 


When you call the getArray() method in Figure 8-20, you can store its returned value in 
any integer array reference. For example, you might declare an array and make the method 
call in the following statement: 


intl] scoresFromMethod = getArray(); 


SO 
ul Watch the video Arrays and Methods. 





Passing Arrays to and Returning Arrays from Methods 


1. You pass a single array element to a method using its name, and the method 
must be prepared to receive the appropriate data type. 


2. You pass an array to a method using its name followed by a pair of brackets; 
arrays are passed by value. 


3. When a method returns an array reference, you include square brackets with 
the return type in the method header. 


‘POUJELW By} 0} passed si ssauppe sAeie ay} 
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Xv You Do It 


Passing an Array to a Method 
430 





Next, you add a method to the BowlingTeamDemo3 application. The improvement 
allows you to remove the data entry process from the main program and encapsulate 
the process in its own method. 


1. Inyour text editor, open the BowlingTeamDemo3.java file if it is not already 
open. Immediately save the file as BowlingTeamDemo4.java. Change the 
class name to match the filename. 


2. Just before the closing curly brace for the class, add the following shell for 
a method that accepts a BowlingTeam array argument. 


public static void getTeamData(BowlingTeam[] teams) 
{ 
} 


3. Within the getTeamDataQ method, add the following six declarations (or 
copy them from the main@ method): 


String name; 

final int NUM_TEAMS = 4; 

int x; 

int y; 

final int NUM_TEAM_MEMBERS = 4; 

Scanner input = new Scanner (System. in); 


4. Cut the 13 lines of code that assign memory to the BowlingTeam array and 
obtain all the data values. Place these 13 lines within the getTeamDataQ) 
method following the declarations. 


for(y = 0; y < NUM_TEAMS; ++y) 
{ 
teams[y] = new Bowl ingTeamQ() ; 
System.out.print("Enter team name >> "); 
name = input.nextLineQ); 
teams[y] .setTeamName (name) ; 
for(x = 0; x < NUM_TEAM_MEMBERS; ++x) 
{ 
System.out.printC"Enter team member's name >> "); 
name = input.nextLineQ; 
teams[y].setMember(x, name) ; 


(continues) 
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(continued) 


5. In place of the 13 cut lines, insert a method call. This call passes a copy of 
the array reference to the method. Notice that this call does not assign a 
return value. The method is a void method and returns nothing. Nevertheless, 431 
the array in the main® method will be updated because the method is 
receiving access to the array’s memory address. 








getTeamData(teams) ; 


6. Save the file (as BowlingTeamDemo4.java), and then compile and execute 
the program. Confirm that the program works exactly as it did before the new 
method was added. 


Don't Do It 


e Don't forget that the lowest array subscript is 0. 
e Don't forget that the highest array subscript is one less than the length of the array. 
e Don't forget the semicolon following the closing curly brace in an array initialization list. 


e Don't forget that length is an array property and not a method. Conversely, lengthQ) is 
a String method and not a property. 


e Don't place a subscript after an object’s field or method name when accessing an array of 
objects. Instead, the subscript for an object follows the object and comes before the dot 
and the field or method name. 


e Don’t assume that an array of characters is a string. Although an array of characters can 
be treated like a string in languages like C++, you can’t do this in Java. For example, if you 
display the name of a character array, you will see its address, not its contents. 


e Don't forget that array names are references. Therefore, you cannot assign one array to 
another using the = operator, nor can you compare array contents using the == operator. 


e Don't use brackets with an array name when you pass it to a method. Do use brackets in 
the method header that accepts the array. 


Key Terms 


An array is a named list of data items that all have the same type. 


An element is one variable or object in an array. 
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A subscript is an integer contained within square brackets that indicates one of an array’s 
elements. 


An index is a subscript. 


Out of bounds describes a subscript that is not within the allowed range for an array. 
432 





An initialization list is a series of values provided for an array when it is declared. 
Populating an array is the act of providing values for all the elements. 

The length field contains the number of elements in an array. 

An object’s instance variable or field is also called a property of the object. 


The enhanced for loop allows you to cycle through an array without specifying the starting 
and ending points for the loop control variable. 


A foreach loop is an enhanced for loop. 


Searching an array is the process of comparing a value to a list of values in an array, 
looking for a match. 


A parallel array is one with the same number of elements as another and for which the values 
in corresponding elements are related. 


A range match is the process of comparing a value to the endpoints of numerical ranges 
to find a category in which the value belongs. 


When a variable is passed by value to a method, a copy is made in the receiving method. 


Arrays are reference types, meaning that the object actually holds a memory address 
where the values are stored. 


When a value is passed by reference to a method, the address is passed to the method. 


Chapter Summary 


e An array is a named list of data items that all have the same type. You declare an array 
variable by inserting a pair of square brackets after the type. To reserve memory space for 
an array, you use the keyword new. You use a subscript contained within square brackets 
to refer to one of an array’s variables, or elements. In Java, any array’s elements are 
numbered beginning with zero. 














e Array names represent computer memory addresses. When you declare an array name, 
no computer memory address is assigned to it. Instead, the array variable name has the 
special value nu11. When you use the keyword new or supply an initialization list, then 
an array acquires an actual memory address. When an initialization list is not provided, 
each data type has a default value for its array elements. 
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e You can shorten many array-based tasks by using a variable as a subscript. When an 
application contains an array, it is common to perform loops that execute from 0 to 
one less than the size of the array. The length field is an automatically created field that 
is assigned to every array; it contains the number of elements in the array. 


e Just as you can declare arrays of integers or doubles, you can declare arrays that hold 
elements of any type, including Strings and other objects. To use a method that belongs 
to an object that is part of an array, you insert the appropriate subscript notation after 
the array name and before the dot that precedes the method name. 


433 








e By looping through an array and making comparisons, you can search an array to find 
a match to a value. You can use a parallel array with the same number of elements to 
hold related elements. You perform a range match by placing end values of a numeric 
range in an array and making greater-than or less-than comparisons. 


e You can pass a single array element to a method in exactly the same manner as you would 
pass a simple variable, and the array receives a copy of the passed value. However, arrays, 
like all objects, are reference types; this means that when an array name is passed to a 
method, the method receives a copy of the array’s memory address and has access to 
the values in the original array. 


Review Questions 


1. An array is a list of data items that 


a. all have the same type c. all are integers 
b. all have different names d. all are null 


2. When you declare an array, 
you always reserve memory for it in the same statement 
you might reserve memory for it in the same statement 


you cannot reserve memory for it in the same statement 


oo Ff SP 


the ability to reserve memory for it in the same statement 
depends on the type of the array 






3. You reserve memory locations for an array when you 
declare the array name 

use the keyword new 

use the keyword mem 


ao F SP 


explicitly store values within the array elements 
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10. 


11. 


For how many integers does the following statement reserve room? 
int[] value = new int[34]; 


a. O c. 34 
b. 33 d. 35 


Which of the following can be used as an array subscript? 


a. character c. int 
b. double d. String 


If you declare an array as follows, how do you indicate the final element of 
the array? 
intl] num = new int[6]; 


a. num[0] c. num[6] 
b. num[5] d. impossible to tell 


If you declare an integer array as follows, what is the value of num[2]? 
intl] num = {101, 202, 303, 404, 505, 606}; 


a. 101 c. 303 
b. 202 d. impossible to tell 


Array names represent 


a. values c. references 
b. functions d. allusions 


Unicode value ‘\u0000’ is also known as 


a nil c. nada 
b. void d. nul] 


When you initialize an array by giving it values upon creation, you 
do not explicitly give the array a size 

also must give the array a size explicitly 

must make all the values zero, blank, or false 


ao Ff PS 


must make certain each value is different from the others 


In Java, you can declare an array of 12 elements and initialize 


a. only the first one c. Both of these are true. 
b. all of them d. Neither of these is true. 
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13. 


14. 


15. 


16. 


ve 
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Assume an array is declared as follows. Which of the following statements 
correctly assigns the value 100 to each of the array elements? 


int[] num = new int[4]; 








a. for (x = 0; x < 3; ++x) num[x] = 100; 
b. for(x = 0; x < 4; 4++x) num[x] = 100; 435 
c. for(x = 1; x < 4; ++x) num[x] = 100; 
d. for(x = 1; x < 5; 4++x) num[x] = 100; 


Suppose you have declared an array as follows: 
int[] creditScores = {670, 720, 815}; 
What is the value of creditScores. length? 

a 0 c. 2 
b. 1 d. 3 


If a class named Student contains a method setIDQ that takes an int argument, 
and you write an application in which you create an array of 20 Student objects 
named scholar, which of the following statements correctly assigns an ID number 
to the first Student scholar? 

a. Student[0].setID(1234) ; c. Student.setID[0] (1234) ; 

b. scholar[0].setID(1234); d. scholar.setID[0] (1234); 


A parallel array is one that 


holds values that correspond to those in another array 
holds an even number of values 
is placed adjacent to another array in code 


ao oP 


is placed adjacent to another array in memory 
In which of the following situations would setting up parallel arrays be most 
useful? 


a. You need to look up an employee’s ID number to find the employee’s 
last name. 










b. You need to calculate interest earned on a savings account balance. 
You need to store a list of 20 commonly misspelled words. 


fa A 


You need to determine the shortest distance between two points on a map. 


When you pass an array element to a method, the method receives 


a. acopy of the array c. acopy of the value in the element 
b. the address of the array d. the address of the element 
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18. A single array element of a primitive type is passed to a method by 
a. value c. address 
b. reference d. osmosis 

19. When you pass an array to a method, the method receives 
a. acopy of the array 
b. acopy of the first element in the array 
c. the address of the array 
d. nothing 

20. Ifa method should return an array to its calling method, 
a. the method’s return type must match its parameter type 
b. the return type in the method header is preceded by an ampersand 
c. the return type in the method header is followed by square brackets 
d. A Java method cannot return an array. 

Exercises 


=) Programming Exercises 


1. 


Write an application that can hold eight integers in an array. Display the integers 
from first to last, and then display the integers from last to first. Save the file as 
EightInts.java. 


Allow a user to enter any number of double values up to 10. The user should enter 
99999 to quit entering numbers. Display an error message if the user quits without 
entering any numbers; otherwise, display each entered value and its distance from 
the average. Save the file as DistanceFromAverage.java. 


a. Write an application for Carl’s Carpentry that shows a user a list of available 
items: table, desk, dresser, or entertainment center. Allow the user to enter a 
string that corresponds to one of the options, and display the price as $250, 
$325, $420, or $600, accordingly. Display an error message if the user enters 
an invalid item. Save the file as CarpentryChoice.java. 


b. It might not be reasonable to expect users to type long entries such as 
“entertainment center” accurately. Modify the CarpentryChoice class so 
that as long as the user enters the first three characters of a furniture item, 
the choice is considered valid. Save the file as CarpentryChoice2.java. 
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4, Create an application containing an array that stores eight integers. The application 
should (1) display all the integers, (2) display all the integers in reverse order, (3) 
display the sum of the eight integers, (4) display all values less than 5, (5) display 
the lowest value, (6) display the highest value, (7) calculate and display the average, 
and (8) display all values that are higher than the calculated average value. Save 
the file as NumberListDemo.java. 437 








5. Write an application that accepts up to 20 Strings. Divide them into two lists—one 
for short Strings that are five characters or fewer, and the other for long Strings. 
After data entry is complete, prompt the user to enter which type of String to 
display, and then output the correct list. If there are no Strings in a requested list, 
then output an appropriate message. Save the file as DivideStrings.java. 


6. a. Create a class named Salesperson. Data fields for Salesperson include an integer 
ID number and a double annual sales amount. Methods include a constructor 
that requires values for both data fields, as well as get and set methods for each of 
the data fields. Write an application named DemoSalesperson that declares an 
array of 10 Salesperson objects. Set each ID number to 9999 and each sales value 
to zero. Display the 10 Salesperson objects. Save the files as Salesperson.java 
and DemoSalesperson.java. 


b. Modify the DemoSalesperson application so each Salesperson has a successive 
ID number from 111 through 120 and a sales value that ranges from $25,000 to 
$70,000, increasing by $5,000 for each successive Salesperson. Save the file as 
DemoSalesperson2.java. 


7. a. Create a CollegeCourse class. The class contains fields for the course ID (for 
example, “CIS 210”), credit hours (for example, 3), and a letter grade (for example, 
‘A’). Include get and set methods for each field. Create a Student class containing 
an ID number and an array of five Col legeCourse objects. Create a get () and set() 
method for the Student ID number. Also create a get() method that returns one 
of the Student’s CollegeCourses; the method takes an integer argument and 
returns the CollegeCourse in that position (0 through 4). Next, create a set () 
method that sets the value of one of the Student’s CollegeCourses; the method 
takes two arguments—a CollegeCourse and an integer representing the 
CollegeCourse’s position (0 through 4). Save the files as CollegeCourse.java 
and Student.java. 













b. Write an application that prompts a professor to enter grades for five different 
courses each for 10 students. Prompt the professor to enter data for one student at a 
time, including student ID and course data for five courses. Use prompts containing 
the number of the student whose data is being entered and the course number—for 
example, “Enter ID for student #s”, where s is an integer from 1 through 10, 
indicating the student, and “Enter course ID #n”, where 7 is an integer from 1 
through 5, indicating the course number. Verify that the professor enters only A, B, 
C, D, or F for the grade value for each course. Save the file as InputGrades.java. 
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8. Write an application in which the user can enter a date using digits and slashes 
(for example, “6/24/2014”), and receive output that displays the date with the month 
shown as a word (such as “June 24, 2014”). Allow for the fact that the user might or 
might not precede a month or day number with a zero (for example, the user might 
type “06/24/2014” or “6/24/2014”). Do not allow the user to enter an invalid date, 
438 defined as one for which the month is less than 1 or more than 12, or one for 
which the day number is less than 1 or greater than the number of days in the 
specified month. Also display the date’s ordinal position in the year; for example, 
6/24/14 is the 175th day of the year. In this application, use your knowledge of arrays 
to store the month names, as well as values for the number of days in each month 
so that you can calculate the number of days that have passed. Save the application 
as ConvertDate.java. 





When determining whether a date is valid and when calculating the number of days that have passed, 
remember that some years are leap years. In a leap year, February 29th is added to the calendar. A leap 
year is any year that is evenly divisible by 4, unless the year is also evenly divisible by 100. So 1908 and 
2008 were both leap years, but 1900 was not a leap year. Another exception occurs when a year is evenly 
divisible by 400—the year is a leap year. Therefore, 2000 was a leap year, but 2100 will not be one. 





9. Write an application that allows a user to enter the names and phone numbers of up 
to 20 friends. Continue to prompt the user for names and phone numbers until the 
user enters “zzz” or has entered 20 names, whichever comes first. When the user is 
finished entering names, produce a count of how many names were entered, but make 
certain not to count the application-ending dummy “zzz” entry. Then display the 
names. Ask the user to type one of the names and display the corresponding phone 
number. Save the application as PhoneBook.java. 


10. Write an application containing three parallel arrays that hold 10 elements each. 
The first array holds four-digit student ID numbers, the second holds first names, 
and the third holds the students’ grade point averages. Use dialog boxes to accept a 
student ID number and display the student’s first name and grade point average. If a 
match is not found, display an error message that includes the invalid ID number and 
allow the user to search for a new ID number. Save the file as StudentIDArray.java. 


11. A personal phone directory contains room for first names and phone numbers for 30 
people. Assign names and phone numbers for the first 10 people. Prompt the user for 
a name, and if the name is found in the list, display the corresponding phone number. 
If the name is not found in the list, prompt the user for a phone number, and add the 
new name and phone number to the list. Continue to prompt the user for names until 
the user enters “quit”. After the arrays are full (containing 30 names), do not allow the 
user to add new entries. Save the file as PhoneNumbers.java. 















12. In the Exercises in Chapter 4, you created a CertificateOfDeposit class 
and a TestCertificateOfDeposit application that instantiated two 
CertificateOfDeposit objects. Now, modify the application to accept data for 
an array of five CertificateOfDeposit objects, and then display the data. Save the 
application as TestCertificateOfDepositArray.java. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 


13. In the Exercises in Chapter 5, you created a DigitalCamera class and a 
TestDigitalCamera application that accepted and displayed data for four 
DigitalCamera objects. Now, modify the TestDigitalCamera application to use 
an array of four DigitalCamera objects instead of four individual ones. Save the 


application as TestDigitalCameraArray.java. 
439 








% Debugging Exercises 


1. Each of the following files in the Chapter08 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and 
fix the program. After you correct the errors, save each file using the same 
filename preceded with Fix. For example, DebugEight1.java will become 


FixDebugEight1 java. 
a. DebugEightl java c. DebugEight3 java 
b. DebugEight2.java d. DebugEight4.java 


o, Game Zone 


1. Write an application that contains an array of 10 multiple-choice quiz questions 
related to your favorite hobby. Each question contains three answer choices. Also 
create an array that holds the correct answer to each question—A, B, or C. Display 
each question and verify that the user enters only A, B, or C as the answer—if not, 
keep prompting the user until a valid response is entered. If the user responds to a 
question correctly, display “Correct!”; otherwise, display “The correct answer is” and 
the letter of the correct answer. After the user answers all the questions, display the 
number of correct and incorrect answers. Save the file as Quiz.java. 


2. a. In Chapter 4, you created a Die application that randomly “throws” five dice for 
the computer and five dice for the player. The application displays the values. 
Modify the application to decide the winner based on the following hierarchy of 
Die values. Any higher combination beats a lower one; for example, five of a kind 
beats four of a kind. 


e Five ofa kind 
e Four ofa kind 


e Three of a kind 







e A pair 


For this game, the dice values do not count; for example, if both players have 
three of a kind, it’s a tie, no matter what the values of the three dice are. 
Additionally, the game does not recognize a full house (three of a kind plus 
two of a kind). Figure 8-21 shows a sample execution. Save the application as 
FiveDice2.java. 
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re 
fa Command Prompt 






C:\Java>java FiveDice2 
Computer rolled: 41216 
You rolled: 26444 
Computer has 2 of a kind 
440 You have 3 of a kind 


WYou win 





C:=\Java> 





Figure 8-21 Typical execution of the FiveDice2 application 


b. Improve the FiveDice2 game so that when both players have the same 
combination of dice, the higher value wins. For example, two 6s beats two 
5s. Figure 8-22 shows an example execution. Save the application as 
FiveDice3.java. 


rc - 
fH Command Prompt ei) 


C:\Java>java FiveDice3 
Computer rolled: 32261 
You rolled: 1143 2 








Computer’s values are higher — computer wins 


C:\Java> 














Figure 8-22 Typical execution of the FiveDice3 application 


3. a. In Chapter 7, you modified a previously created Card class so that each Card would 


” « yn 


hold the name of a suit (“Spades”, “Hearts”, “Diamonds”, or “Clubs”) as well as a 
value (“Ace”, “King”, “Queen”, “Jack”, or a number value). Now, create an array of 
52 Card objects, assigning a different value to each Card, and display each Card. 


Save the application as FullDeck.java. 













b. In Chapter 7, you created a War2 card game that randomly selects two Card objects 
(one for the player and one for the computer) and declares a winner or a tie based 
on the card values. Now create a game that plays 26 rounds of War, dealing a full 
deck with no repeated cards. Some hints: 


e Start by creating an array of all 52 playing cards, as in Part a of this exercise. 


e Select a random number for the deck position of the player’s first card, and 
assign the card at that array position to the player. 
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e Move every higher-positioned card in the deck “down” one to fill in the gap. 
In other words, if the player’s first random number is 49, select the card at 
position 49, move the card that was in position 50 to position 49, and move 
the card that was in position 51 to position 50. Only 51 cards remain in the 
deck after the player’s first card is dealt, so the available-card array is smaller 
by one. 441 


e Inthe same way, randomly select a card for the computer and “remove” 
the card from the deck. 








e Display the values of the player’s and computer’s cards, compare their 
values, and determine the winner. 


e When all the cards in the deck are exhausted, display a count of the 
number of times the player wins, the number of times the computer 
wins, and the number of ties. 


Save the game as War3.java. 


4, In Chapter 7, you created a Secret Phrase game similar to Hangman, in which the 
user guesses letters in a partially hidden phrase in an attempt to determine the 
complete phrase. Modify the program so that: 


e The phrase to be guessed is selected randomly from a list of at least 10 phrases. 


e The clue is presented to the user with asterisks replacing letters to be guessed 
but with spaces in the appropriate locations. For example, if the phrase to be 
guessed is “No man is an island,” then the user sees the following as a first clue: 


The spaces provide valuable clues as to where individual words start and end. 


e Make sure that when a user makes a correct guess, all the matching letters are 
filled in, regardless of case. 


Save the game as SecretPhrase2.java. 


Case Problems 














1. In previous chapters, you developed classes that work with catering event information 
for Carly’s Catering. Now modify the Event and EventDemo classes as follows: 


e Modify the Event class to include an integer field that holds an event type. Add a 
final String array that holds names of the types of events that Carly’s caters— 
wedding, baptism, birthday, corporate, and other. Include get and set methods 
for the integer event type field. If the argument passed to the method that sets the 
event type is larger than the size of the array of String event types, then set the 
integer to the element number occupied by “other”. Include a get method that 
returns an event’s String event type based on the numeric event type. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce: reserves the right to remove additi 


CHAPTER 8 Arrays 


e To keep the EventDemo class simple, remove all the statements that compare 
event sizes and that display the invitation Strings. 


e Modify the EventDemo class so that instead of creating three single Event 
objects, it uses an array of three Event objects. Get data for each of the objects, 
442 and then display all the details for each object. 





Save the files as Event.java and EventDemo.java. 


2. In previous chapters, you developed classes that hold rental contract information 
for Sammy’s Seashore Supplies. Now modify the Rental and RentalDemo classes as 
follows: 


e Modify the Rental class to include an integer field that holds an equipment 
type. Add a final String array that holds names of the types of equipment 
that Sammy’s rents—jet ski, pontoon boat, rowboat, canoe, kayak, beach chair, 
umbrella, and other. Include get and set methods for the integer equipment 
type field. If the argument passed to the method that sets the equipment type is 
larger than the size of the array of String equipment types, then set the integer 
to the element number occupied by “other”. Include a get method that returns 
a rental’s String equipment type based on the numeric equipment type. 


e To keep the RentalDemo class simple, remove all the statements that compare 
rental times and that display the coupon Strings. 


e Modify the RentalDemo class so that instead of creating three single Rental 
objects, it uses an array of three Rental objects. Get data for each of the objects, 
and then display all the details for each object. 


Save the files as Rental.java and RentalDemo.java. 
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Advanced Array 
Concepts 


In this chapter, you will: 


Sort array elements using the bubble sort algorithm 


(©) 


Sort array elements using the insertion sort algorithm 


(©) 


Use two-dimensional and other multidimensional arrays 


(©) 


Use the Arrays Class 


(©) 


Use the ArrayList class 


(©) 


Create enumerations 


(©) 
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CHAPTER 9 Advanced Array Concepts 


Sorting Array Elements Using the Bubble 
Sort Algorithm 


Sorting is the process of arranging a series of objects in some logical order. When you 

place objects in order, beginning with the object that has the lowest value, you are sorting 

444 in ascending order; conversely, when you start with the object that has the largest value, 
you are sorting in descending order. 





The simplest possible sort involves two values that are out of order. To place the values 
in order, you must swap the two values. Suppose that you have two variables—valA and 
valB—and further suppose that valA = 16 and valB = 2. To exchange the values of the 
two variables, you cannot simply use the following code: 


valA 
valB 


valB; // 2 goes to valA 
valA; // 2 goes to valB 


If valB is 2, after you execute valA = va1B;, both variables hold the value 2. The value 16 that 
was held in va1A is lost. When you execute the second assignment statement, valB = valA;, 
each variable still holds the value 2. 


The solution that allows you to retain both values is to employ a variable to hold valA’s 
value temporarily during the swap: 


temp = valA; // 16 goes to temp 
valA = valB; // 2 goes to valA 
valB temp; // 16 goes to valB 


Il 


Il 


Using this technique, valA’s value (16) is assigned to the temp variable. The value of valB 
(2) is then assigned to valA, so valA and va1B are equivalent. Then, the temp value (16) is 
assigned to va1B, so the values of the two variables finally are swapped. 


If you want to sort any two values, valA and va1B, in ascending order so that valA is always 
the lower value, you use the following if statement to make the decision whether to swap. 

If valA is more than va1B, you want to swap the values. If valA is not more than va1B, you 
do not want to swap the values. 


if(valA > valB) 


{ 
temp = valA; 
valA = valB; 
valB = temp; 
} 


Sorting two values is a fairly simple task; sorting more values (valC, va1D, valE, and 
so on) is more complicated. The task becomes manageable when you know how to use 
an array. 
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Sorting Array Elements Using the Bubble Sort Algorithm D0 


Using the Bubble Sort Algorithm 


As an example, you might have a list of five numbers that you want to place in ascending 

order. Multiple sorting algorithms have been developed; an algorithm is a process or set 

of steps that solve a problem. In the bubble sort algorithm, you continue to compare pairs of 

items, swapping them if they are out of order, so that the smallest items “bubble” to the top 445 
of the list, eventually creating a sorted list. The bubble sort is neither the fastest nor most 
efficient sorting technique, but it is one of the simplest to comprehend and provides 
deeper understanding of array element manipulation. 








To use a bubble sort, you place the original, unsorted values in an array, such as the 
following: 


int[] someNums = {88, 33, 99, 22, 54}; 


You compare the first two numbers; if they are not in ascending order, you swap them. You 
compare the second and third numbers; if they are not in ascending order, you swap them. 
You continue down the list. Generically, for any someNums[x], if the value of someNums [x] 
is larger than someNums[x + 1], you want to swap the two values. 


With the numbers 88, 33, 99, 22, and 54, the process proceeds as follows: 


e Compare 88 and 33. They are out of order. Swap them. The list becomes 33, 88, 
99, 22, 54. 


e Compare the second and third numbers in the list—88 and 99. They are in order. 
Do nothing. 


e Compare the third and fourth numbers in the list—99 and 22. They are out of order. 
Swap them. The list becomes 33, 88, 22, 99, 54. 


e Compare the fourth and fifth numbers—99 and 54. They are out of order. Swap them. 
The list becomes 33, 88, 22, 54, 99. 


When you reach the bottom of the list, the numbers are not in ascending order, but the 
largest number, 99, has moved to the bottom of the list. This feature gives the bubble sort 
its name—the “heaviest” value has sunk to the bottom of the list as the “lighter” values have 
bubbled to the top. 


Assuming b and temp both have been declared as integer variables, the code so far is 
as follows: 


for(b = 0; b < someNums.Jength - 1; ++b) 
if(someNums[b] > someNums[b + 1]) 
{ 
temp = someNums[b]; 
someNums[b] = someNums[b + 1]; 
someNums[b + 1] = temp; 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 9 Advanced Array Concepts 


efficient to declare a variable to which you assign someNums. length —- 1 and use that variable in the 
comparison. That way, the arithmetic is performed just once. That step is omitted here to reduce the number 
of steps in the example. 


Q Instead of comparing b to someNums.]length - 1 on every pass through the loop, it would be more 
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Notice that the for statement tests every value of b from 0 through 3. The array someNums 
contains five integers, so the subscripts in the array range in value from 0 through 4. Within 
the for loop, each someNums[b] is compared to someNums[b + 1], so the highest legal value 
for b is 3. For a sort on any size array, the value of b must remain less than the array’s length 
minus 1. 


The list of numbers that began as 88, 33, 99, 22, 54 is currently 33, 88, 22, 54, 99. To continue 
to sort the list, you must perform the entire comparison-swap procedure again. 


e Compare the first two values—33 and 88. They are in order; do nothing. 


e Compare the second and third values—88 and 22. They are out of order. Swap them 
so the list becomes 33, 22, 88, 54, 99. 


e Compare the third and fourth values—88 and 54. They are out of order. Swap them so 
the list becomes 33, 22, 54, 88, 99. 


e Compare the fourth and fifth values—88 and 99. They are in order; do nothing. 


After this second pass through the list, the numbers are 33, 22, 54, 88, and 99—close to 
ascending order, but not quite. You can see that with one more pass through the list, the 
values 22 and 33 will swap, and the list is finally placed in order. To fully sort the worst-case 
list, one in which the original numbers are descending (as out-of-ascending order as they 
could possibly be), you need to go through the list four times, making comparisons and swaps. 
At most, you always need to pass through the list as many times as its length minus one. 
Figure 9-1 shows the entire procedure. 


for(a = 0; a < someNums. length - 1; ++a) 
for(b = 0; b < someNums. length - 1; ++b) 
ifC(someNums[b] > someNums[b + 1]) 


{ 


temp = someNums[b]; 
someNums[b] = someNums[b + 1]; 
someNums[b + 1] = temp; 





Figure 9-1 Ascending bubble sort of the someNums array elements 


To place the list in descending order, you need to make only one change in the code in Figure 9-1: You 
Y change the greater-than sign( >) in if(someNums[b] > someNums[b + 1]) toa less-than sign ( <). 
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When you use a bubble sort to sort any array into ascending order, the largest value “falls” 
to the bottom of the array after you have compared each pair of values in the array one time. 
The second time you go through the array making comparisons, there is no need to check 
the last pair of values. The largest value is guaranteed to already be at the bottom of the 
array. You can make the sort process even more efficient by using a new variable for the 
inner for loop and reducing the value by one on each cycle through the array. Figure 9-2 447 
shows how you can use a new variable named comparisonsToMake to control how many 
comparisons are made in the inner loop during each pass through the list of values to be 
sorted. In the shaded statement, the compari sonsToMake value is decremented by 1 on each 
pass through the list. 








int comparisonsToMake = someNums. length - 1; 
for(a = 0; a < someNums. length - 1; ++a) 


for(b = 0; b < comparisonsToMake; ++b) 
{ 
ifC(someNums[b] > someNums[b + 1]) 
{ 
temp = someNums[b] ; 
someNums[b] = someNums[b + 1]; 
someNums[b + 1] = temp; 
} 
} 


--comparisonsToMake; 





Figure 9-2 More efficient ascending bubble sort of the someNums array elements 
ee 
a) Watch the video Sorting. 


Sorting Arrays of Objects 


You can sort arrays of objects in much the same way that you sort arrays of primitive types. 
The major difference occurs when you make the comparison that determines whether 
you want to swap two array elements. When you construct an array of the primitive 
element type, you compare the two array elements to determine whether they are out of 
order. When array elements are objects, you usually want to sort based on a particular 
object field. 


Assume that you have created a simple Employee class, as shown in Figure 9-3. The class 
holds four data fields and get and set methods for the fields. 
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public class Employee 
{ 
private int empNum; 
private String lastName; 
private String firstName; 
448 private double salary; 
public int getEmpNum() 
{ 


} 
public void setEmpNumCint emp) 


{ 


} 
public String getLastName() 
{ 





return empNum; 


empNum = emp; 


return lastName; 


public void setLastName(String name) 


3 


} 
public String getFirstName() 


{ 
} 


public void setFirstName(String name) 


{ 


} 
public double getSalaryQ 


{ 
} 
public void setSalary(double sal) 
{ 


} 


lastName = name; 


return firstName; 


firstName = name; 


return salary; 


salary = sal; 





Figure 9-3 The Employee class 


You can write a program that contains an array of five Employee objects using the 
following statement: 


Employee[] someEmps = new Employee[5]; 
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Assume that after you assign employee numbers and salaries to the Employee objects, 
you want to sort the Employees in salary order. You can pass the array to a 
bubbleSort() method that is prepared to receive Employee objects. Figure 9-4 shows 
the method. 
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public static void bubbleSort(Employee[] array) 
{ 

int a, b; 

Employee temp; 

int highSubscript = array.length - 1; 

for(a = 0; a < highSubscript; ++a) 

for(b = 0; b < highSubscript; ++b) 


if(array[b].getSalaryQ > array[b + 1].getSalary() 
{ 


temp = array[b]; 
array[b] = array[b + 1]; 
array[b + 1] = temp; 





Figure 9-4 The bubbleSort() method that sorts Employee objects by their salaries 


Examine Figure 9-4 carefully, and notice that the bubbleSort() method is very similar to the 
bubbleSort() method you use for an array of any primitive type, but there are three major 
differences: 


e The bubbleSort() method header shows that it receives an array of type Employee. 


e The temp variable created for swapping is type Employee. The temp variable will 
hold an Employee object, not just one number or one field. It is important to note 
that even though only employee salaries are compared, you do not just swap 
employee salaries. You do not want to substitute one employee’s salary for another’s. 
Instead, you swap each Employee object’s empNum and salary as a unit. 


e The comparison for determining whether a swap should occur uses method calls to the 
getSalary() method to compare the returned salary for each Employee object in the 
array with the salary of the adjacent Employee object. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 9 Advanced Array Concepts 


Sorting Array Elements Using the Bubble Sort Algorithm 


450 1. In an ascending bubble sort, you compare pairs of items, swapping them if they 
are out of order, so that the largest items “bubble” to the top of the list, 
eventually creating a sorted list. 


2. When you sort objects, you usually want to sort based on a particular object field. 


3. When you make a swap while sorting an array of objects, you typically swap 
entire objects and not just the field on which the comparison is made. 
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om You Do It 


Using a Bubble Sort 


In this section, you create a program in which you enter values that you sort using the 
bubble sort algorithm. You display the values during each iteration of the outer 
sorting loop so that you can track the values as they are repositioned in the array. 


1. Open a new file in your text editor, and create the shell for a BubbleSortDemo 
program as follows: 


import java.util.*; 
class BubbleSortDemo 


{ 
public static void main(String[] args) 


{ 
} 
} 

2. Make some declarations between the curly braces of the mainQ method. 
Declare an array of five integers and a variable to control the number of 
comparisons to make during the sort. Declare a Scanner object, two integers 
to use as subscripts for handling the array, and a temporary integer value 
to use during the sort. 


(continues) 
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(continued) 


int[] someNums = new int[5]; 

int comparisonsToMake = someNums.length - 1; 
Scanner keyboard = new Scanner (System. in); 451 
int a, b, temp; 


3. Write a for loop that prompts the user for a value for each array element 
and accepts them. 








for(a = 0; a < someNums.length; ++a) 


{ 


System.out.printC"Enter number " + (a + 1) + " >> "); 


someNums[a] = keyboard.nextIintQ) ; 


} 


4. Next, call a method that accepts the array and the number of sort iterations 
performed so far, which is 0. The purpose of the method is to display the 
current status of the array as it is being sorted. 


display(someNums, 0); 


5. Add the nested loops that perform the sort. The outer loop controls the 
number of passes through the list, and the inner loop controls the 
comparisons on each pass through the list. When any two adjacent elements 
are out of order, they are swapped. At the end of the nested loop, the current 
list is output and the number of comparisons to be made on the next pass is 
reduced by one. 


for(a = 0; a < someNums.length - 1; ++a) 
{ 
for(b = 0; b < comparisonsToMake; ++b) 
{ 
ifCsomeNums[b] > someNums[b + 1]) 
{ 
temp = someNums[b]; 
someNums[b] = someNums[b + 1]; 
someNums[b + 1] = temp; 
} 
} 
display(someNums, (a + 1)); 
--comparisonsToMake; 


} 


6. After the closing brace for the main(@ method, but before the closing brace 
for the class, insert the display method. It accepts the array and the 
current outer loop index, and it displays the array contents. 


(continues) 
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(continued) 


public static void displayCint[] someNums, int a) 
{ 
System.out.print("Iteration "+a+": "); 
forCint x = 0; x < someNums.length; ++x) 
System.out.print(someNums[x] + " "); 
System.out.printinQ; 
} 


Save the file as BubbleSortDemo.java, and then compile and execute it. 
Figure 9-5 shows a typical execution. Notice that after the first iteration, 
the largest value has sunk to the bottom of the list. After the second 
iteration, the two largest values are at the bottom of the list, and so on. 


BubbleSort Demo 
number 1 >> 88 
number 2 >> 7? 
number 3 >> 66 
number 4 >> 55 
number 5 >> 44 


Iteration @: 88 77 66 
Iteration : 7? 66 55 
Iteration 66 55 44 
Iteration 55 44 66 
Iteration 44 55 66 


Cz\Java> 





Figure 9-5 Typical execution of the Bubb1eSortDemo application 


Modify the Bubb1eSortDemo application to any size array you choose. Confirm 
that no matter how many array elements you specify, the sorting algorithm 
works correctly and ends with a completely sorted list, regardless of the 
order of your entered values. 
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Sorting Array Elements Using the Insertion 
Sort Algorithm 


The bubble sort works well and is relatively easy to understand and manipulate, but many 
other sorting algorithms have been developed. For example, when you use an insertion sort, 
you look at each list element one at a time. If an element is out of order relative to any of the 453 
items earlier in the list, you move each earlier item down one position and then insert the 

tested element. The insertion sort is similar to the technique you would most likely use to sort 

a group of objects manually. For example, if a list contains the values 2, 3, 1, and 4, and you 

want to place them in ascending order using an insertion sort, you test the values 2 and 3, but 

you do not move them because they are in order. However, when you test the third value in 

the list, 1, you move both 2 and 3 to later positions and insert 1 at the first position. 








Figure 9-6 shows the logic that performs an ascending insertion sort using a five-element 
integer array named someNums. The logic assumes that a, b, and temp have all been declared 
as integers. 


int[] someNums = {90, 85, 65, 95, 75}; 
1; 
whileCa < someNums. length) 


{ 


temp = someNums[a]; 
b=a--1; 
while(b >= 0 && someNums[b] > temp) 


{ 
someNums[b + 1] = someNums[b]; 
--b; 

} 

someNums[b + 1] = temp; 

++a3 





Figure 9-6 The insertion sort 


The outer loop in Figure 9-6 varies a loop control variable a from 1 through one less than 
the size of the array. The logic proceeds as follows: 


First a is set to 1, and then the while loop begins. 
1. The value of temp is set to someNums[1], which is 85, and b is set to 0. 


2. Because b is greater than or equal to 0 and someNums[b] (90) is greater than temp, the 
inner loop is entered. (If you were performing a descending sort, then you would ask 
whether someNums[b] was less than temp.) 


3. The value of someNums[1] becomes 90 and b is decremented, making it —1, so b is no 
longer greater than or equal to 0, and the inner loop ends. 


4. Then someNums[0] is set to temp, which is 85. 
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After these steps, 90 was moved down one position and 85 was inserted in the first position, 
so the array values are in slightly better order than they were originally. The values are as 
follows: 85, 90, 65, 95, 75. 
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Now, in the outer loop, a becomes 2. The logic in Figure 9-6 proceeds as follows: 


1. 
2: 


5. 


The value of temp becomes 65, and b is set to 1. 


The value of b is greater than or equal to 0, and someNums [b] (90) is greater than temp, 
so the inner loop is entered. 


The value of someNums[2] becomes 90 and b is decremented, making it 0, so the loop 
executes again. 


The value of someNums[1] becomes 85 and b is decremented, making it —1, so the 
loop ends. 


Then someNums[0] becomes 65. 


After these steps, the array values are in better order than they were originally, because 65 
and 85 now both come before 90. The values are: 65, 85, 90, 95, 75. Now, a becomes 3. 
The logic in Figure 9-6 proceeds to work on the new list as follows: 


1. 
2. 


The value of temp becomes 95, and b is set to 2. 


For the loop to execute, b must be greater than or equal to 0, which it is, and 
someNums[b] (90) must be greater than temp, which it is not. So, the inner loop 
does not execute. 


Therefore, someNums [2] is set to 90, which it already was. In other words, no changes 
are made. 


Now, a is increased to 4. The logic in Figure 9-6 proceeds as follows: 


1. 
2. 


The value of temp becomes 75, and b is set to 3. 


The value of b is greater than or equal to 0, and someNums [b] (95) is greater than temp, 
so the inner loop is entered. 


The value of someNums[4] becomes 95 and b is decremented, making it 2, so the loop 
executes again. 


The value of someNums[3] becomes 90 and b is decremented, making it 1, so the 
loop executes again. 


The value of someNums[2] becomes 85 and b is decremented, making it 0; someNums [b] 
(65) is no longer greater than temp (75), so the inner loop ends. In other words, the 
values 85, 90, and 95 are each moved down one position, but 65 is left in place. 


Then someNums[1] becomes 75. 


After these steps, all the array values have been rearranged in ascending order as 
follows: 65, 75, 85, 90, 95. 


Eu Watch the video The Insertion Sort. 
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Many sorting algorithms exist in addition to the bubble sort and insertion sort. You might want to 
Y investigate the logic used by the selection sort, cocktail sort, gnome sort, and quick sort. 
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Sorting Array Elements Using the Insertion Sort Algorithm 


1. When you use an insertion sort, you look at each list element one at a time 
and move items down if the tested element should be inserted before them. 


You can create an ascending list using an insertion sort, but not a descending one. 


The insertion sort is similar to the technique you would most likely use to sort a 
group of objects manually. 
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«a You Do It 


Using an Insertion Sort 


In this section, you modify the BubbleSortDemo program So it performs an 
insertion sort. 


1. Open the BubbleSortDemo.java file. Change the class name 
to InsertionSortDemo, and immediately save the file as 
InsertionSortDemo.java. 


2. Remove the declaration for comparisonsToMake. 


3. Remove the 14 lines of code that constitute the nested loops that perform 
the bubble sort. In other words, remove all the lines from the start of the 
second for loop through the closing curly brace following the statement 
that decrements comparisonsToMake. 


4. Replace the removed lines with the statements that perform the insertion sort. 
These are the same statements you saw in Figure 9-6 with the addition of a call 
to the displayQ method so that you can track the progress of the sort: 


(continues) 
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el = ils 


while(a < someNums.1ength) 


{ 
temp = 
)} Sey > ie 
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someNums [a]; 


Advanced Array Concepts 


(continued) 


while(b >= 0 && someNums[b] > temp) 


{ 


someNums[b + 1] = 


--b; 
} 


someNums[b + 1] 


temp; 


display(someNums, a); 


++a5 


} 


someNums [b] ; 


5. Save the file as InsertionSortDemo.java, and then compile and execute it. 
Figure 9-7 shows a typical execution. During the first loop, 77 is compared 
with 88 and inserted at the beginning of the array. In the second loop, 66 is 
compared with both 77 and 88 and inserted at the beginning of the array. 
Then the same thing happens with 55 and 44 until all the values are sorted. 





Ga 


C2\Java>java 
number 
number 
number 
number 
number 

Iteration @: 

Iteration 1: 

Iteration 2: 

Iteration 3: 

Iteration 4: 


CoNJava>_ 





fay Command Prompt 


Insert ionSort Demo 
1 >> 88 
7 eS ane 
3 >> 66 
4 >> 55 
5 >> 44 


88 
fats 
66 
55 
44 


?? 66 
88 66 
?? 88 
66 77 
55 66 





Figure 9-7 Typical execution of the InsertionSortDemo program 


6. Try the program with other input values, and examine the output so that you 
understand how the insertion sort algorithm works. 
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Using Two-Dimensional and Other 
Multidimensional Arrays 


When you declare an array such as int[] someNumbers = new int[3];, you can envision 
the three declared integers as a column of numbers in memory, as shown in Figure 9-8. 
In other words, you can picture the three declared numbers stacked one on top of the next. 457 
An array that you can picture as a column of values, and whose 
elements you can access using a single subscript, is a 
one-dimensional or single-dimensional array. You can think 

of the size of the array as its height. 








someNumbers [0] 


Java also supports two-dimensional arrays. Two-dimensional arrays 
have two or more columns of values, as shown in Figure 9-9. 
The two dimensions represent the height and width of the array. 
Another way to picture a two-dimensional array is as an array of 
arrays. It is easiest to picture two-dimensional arrays as having 
both rows and columns. You must use two subscripts when 

you access an element in a two-dimensional array. When 
mathematicians use a two-dimensional array, they often call it a 
matrix or a table; you might have used a two-dimensional array 
called a spreadsheet. 


someNumbers [1] 


someNumbers [2] 





Figure 9-8 View of 
a single-dimensional 
array in memory 





someNumbers [0] [0] 


someNumbers [0] [1] 


someNumbers[0] [2] 


someNumbers [0] [3] 





someNumbers[1] [0] 


someNumbers [1] [1] 


someNumbers[1] [2] 


someNumbers [1] [3] 








someNumbers[2] [0] 





someNumbers[2][1] 





someNumbers[2] [2] 








someNumbers[2] [3] 





Figure 9-9 View of a two-dimensional array in memory 


When you declare a one-dimensional array, you type a set of square brackets after the array’s 
data type. To declare a two-dimensional array in Java, you type two sets of brackets after the 
array type. For example, the array in Figure 9-9 can be declared as follows, creating an array 
named someNumbers that holds three rows and four columns: 


int{][] someNumbers = new int[3][4]; 


Just as with a one-dimensional array, if you do not provide values for the elements in a 
two-dimensional numeric array, the values default to zero. You can assign other values to 
the array elements later. For example, someNumbers[0][0] = 14; assigns the value 14 to the 
element of the someNumbers array that is in the first column of the first row. 


Alternatively, you can initialize a two-dimensional array with values when it is created. 
For example, the following code assigns values to someNumbers when it is created: 


int[][] someNumbers = {{8, 9, 10, 11}, 
{1, 3, 12, 15}, 
{5, 9, 44, 99} }; 
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The someNumbers array contains three rows and four columns. You do not need to place 

each row of values for a two-dimensional array on its own line. However, doing so makes 

the positions of values easier to understand. You contain the entire set of values within 

an outer pair of curly braces. The first row of the array holds the four integers 8, 9, 10, 

and 11. Notice that these four integers are placed within their own inner set of curly 

458 braces to indicate that they constitute one row, or the first row, which is row 0. Similarly, 1, 
3, 12, and 15 make up the second row (row 1), which you reference with the subscript 1. 
Next, 5, 9, 44, and 99 are the values in the third row (row 2), which you reference with the 
subscript 2. The value of someNumbers[0] [0] is 8. The value of someNumbers[0] [1] is 9. 
The value of someNumbers[2] [3] is 99. The value within the first set of brackets 
following the array name always refers to the row; the value within the second brackets 
refers to the column. 





As an example of how useful two-dimensional arrays can be, assume that you own an 
apartment building with four floors—a basement, which you refer to as floor zero, and 
three other floors numbered one, two, and three. In addition, each of the floors has studio 
(with no bedroom) and one- and two-bedroom apartments. The monthly rent for each 
type of apartment is different—the higher the floor, the higher the rent (the view is better), 
and the rent is higher for apartments with more bedrooms. Table 9-1 shows the rental 





amounts. 
Floor Zero Bedrooms One Bedroom Two Bedrooms 
0 400 450 510 
1 500 560 630 
Z 625 676 740 
3 1000 1250 1600 


ie) (-) Rents charged (in dollars) 


To determine a tenant’s rent, you need to know two pieces of information: the floor on which 
the tenant rents an apartment and the number of bedrooms in the apartment. Within a Java 
program, you can declare an array of rents using the following code: 


int[][] rents = { {400, 450, 510}, 
{500, 560, 630}, 
{625, 676, 740}, 
{1000, 1250, 1600} }; 


If you declare two integers named floor and bedrooms, then any tenant’s rent can be 
referred to as rents[floor] [bedrooms]. Figure 9-10 shows an application that prompts 
a user for a floor number and number of bedrooms. Figure 9-11 shows a typical 
execution. 
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import javax.swing.*; 
class FindRent 
{ 
public static void main(String[] args) 
{ 459 
int[][] rents = { {400, 450, 510}, 
{500, 560, 630}, 
{625, 676, 740}, 
{1000, 1250, 1600} }; 








String entry; 
int floor; 
int bedrooms; 
entry = JOptionPane.showInputDialog(null, 
"Enter a floor number "); 
floor = Integer.parseInt(entry); 
entry = JOptionPane.showInputDialog(null, 
"Enter number of bedrooms "); 
bedrooms = Integer.parseInt(entry) ; 
JOptionPane.showMessageDialog(null, 
"The rent for a " + bedrooms + 
" bedroom apartment on floor " 


+ floor + 
is $" + rents[floor] [bedrooms]); 


2 Enter a floor number 
i1 














@ The rent for a 2 bedroom apartment on floor 1 is $630 





Figure 9-11 Typical execution of the FindRent program 
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Passing a Two-Dimensional Array to a Method 


When you pass a two-dimensional array to a method, you pass the array name just as you 

do with a one-dimensional array. A method that receives a two-dimensional array uses two 

bracket pairs following the data type in the parameter list of the method header. For example, 
460 the following method headers accept two-dimensional arrays of ints, doubles, and 
Employees, respectively: 





public static void displayScores(Cint[] []scoresArray) 
public static boolean areAl1PricesHigh(double[][] prices) 
public static double computePayrol1ForAllEmployees(Employee[][] staff) 


In each case, notice that the brackets indicating the array in the method header are empty. 
There is no need to insert numbers into the brackets because each passed array name is a 
starting memory address. The way you manipulate subscripts within the method determines 
how rows and columns are accessed. 


Using the length Field with a Two-Dimensional Array 


In Chapter 8, you learned that a one-dimensional array has a length field that holds 
the number of elements in the array. With a two-dimensional array, the length field 
holds the number of rows in the array. Each row, in turn, has a length field that holds 
the number of columns in the row. For example, suppose you declare a rents array 

as follows: 


int[][] rents = { {400, 450, 510}, 
{500, 560, 630}, 
{625, 676, 740}, 
{1000, 1250, 1600} }; 


The value of rents. length is 4 because there are four rows in the array. The value of 
rents[0]. length is 3 because there are three columns in the first row of the rents 
array. Similarly, the value of rents[1]. length also is 3 because there are three columns 
in the second row. 


Figure 9-12 shows an application that uses the length fields associated with the rents 
array to display all the rents. The floor variable varies from 0 through one less than 4 in the 
outer loop, and the bdrms variable varies from 0 through one less than 3 in the inner loop. 
Figure 9-13 shows the output. 
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class DisplayRents 








{ 
public static void main(String[] args) 
{ 
int[][] rents = { {400, 450, 510}, 461 
{500, 560, 630}, 
{625, 676, 740}, 
{1000, 1250, 1600} }; 
int floor; 
int bdrms; 
for(floor = 0; floor < rents. length; ++floor) 
for(bdrms = 0; bdrms < rents[floor].length; ++bdrms) 
System.out.printInC"Floor " + floor + 
" Bedrooms " + bdrms + " Rent is $" + 
rents[floor] [bdrms]); 
} 
} 


Figure 9-12 The DisplayRents class 
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Figure 9-13 Output of the DisplayRents program 


ee 
eu Watch the video Two-Dimensional Arrays. 
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Understanding Ragged Arrays 


In a two-dimensional array, each row also is an array. In Java, you can declare each row 

to have a different length. When a two-dimensional array has rows of different lengths, it 

is a ragged array because you can picture the ends of each row as uneven. You create a 
462 ragged array by defining the number of rows for a two-dimensional array, but not defining 
the number of columns in the rows. For example, suppose that you have four sales 
representatives, each of whom covers a different number of states as their sales territory. 
Further suppose that you want an array to store total sales for each state for each sales 
representative. You would define the array as follows: 





double[][] sales = new double[4][]; 


This statement declares an array with four rows, but the rows are not yet created. Then, 
you can declare the individual rows, based on the number of states covered by each 
salesperson as follows: 


sales[0] = new double[12]; 
sales[1] new double[18]; 
sales[2] new double[9]; 
sales[3] = new double[11]; 


Ul 


Using Other Multidimensional Arrays 


Besides one- and two-dimensional arrays, Java also supports arrays with three, four, 
and more dimensions. The general term for arrays with more than one dimension is 
multidimensional arrays. For example, if you own an apartment building with a number 
of floors and different numbers of bedrooms available in apartments on each floor, you 
can use a two-dimensional array to store the rental fees. If you own several apartment 
buildings, you might want to employ a third dimension to store the building number. 
An expression such as rents[building] [floor] [bedrooms] refers to a specific rent 
figure for a building whose building number is stored in the building variable and 
whose floor and bedroom numbers are stored in the floor and bedrooms variables. 
Specifically, rents[5][1][2] refers to a two-bedroom apartment on the first floor of 
building 5. When you are programming in Java, you can use four, five, or more 
dimensions in an array. As long as you can keep track of the order of the variables 
needed as subscripts, and as long as you don’t exhaust your computer’s memory, Java 
lets you create arrays of any size. 
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Using Two-Dimensional and Other Multidimensional Arrays 


1. Two-dimensional arrays have both rows and columns, so you must use two 463 
subscripts when you access an element in a two-dimensional array. 








2. The following array contains two columns and three rows: 


int{J[J] myArray = {{12, 14, 19}, 
{33, 45, 88}}; 


3. With a two-dimensional array, the length field holds the number of rows in the 
array; each row has a length field that holds the number of columns in the row. 


“SULUN|OD dJY} Ue SMOJ OMI SeY UMOYS Aee dU] ‘ZH SI JUaWAle}s asjel ayy 


aN You Do It 


Using a Two-Dimensional Array 


In this section, you create an application that demonstrates using a two-dimensional 
array. 


1. Open a new file in your text editor, and start a class that will demonstrate a 
working two-dimensional array: 


import java.util .Scanner; 
class TwoDimensionalArrayDemo 


{ 
public static void main(String[] args) 
{ 
2. Declare a three-by-three array of integers. By default, the elements will all be 
initialized to 0. 


int{]Q] count = new int[3][3]; 


3. Declare a Scanner object for input, variables to hold a row and column, 
and a constant that can be used to indicate when the user wants to quit 
the application. 


Scanner input = new Scanner (System. in); 
int row, column; 
final int QUIT = 99; 


(continues) 
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(continued) 


4. Prompt the user to enter a row or the QUIT value to quit, then accept the 
user’s input. 


464 System.out.printC"Enter a row or " + QUIT + 


"to quit > "); 
row = input.nextInt(); 





5. Ina loop that continues if the user has not entered the QuIT value, prompt 
the user for a column. If the row and column are both within appropriate 
ranges, add 1 to the element in the selected position. 


whileCrow != QUIT) 
{ 
System.out.printC"Enter a column > "); 
column = input.nextIntQ); 
ifCrow < count.length && column < count[row].1length) 


{ 


count [row] [column]++; 


6. Still within the if statement that checks for a valid row and column, add a 
nested loop that displays each row and column of the newly incremented 
array. The elements in each row are displayed on the same line, and a new 
line is started at the end of each row. Add a closing curly brace for the 
if statement. 


forCint r = 0; r < count.length; ++r) 


{ 
forCint c = 0; c < count[r].length; ++c) 
System.out.print(count[r][c] +" "); 
System.out.printInQ; 
} 


} 


7. Add an else clause to the if statement to display an error message when 
the row or column value is too high. 


else 
System.out.printInC"Invalid position selected"); 


8. Atthe end of the loop, prompt the user for and accept the next row number. 
Add closing curly braces for the loop, the main® method, and the class. 


System.out.printC"Enter a row or " + QUIT + 
"to quit > "); 
row = input.nextIntQ; 


(continues) 
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(continued) 


9. Save the file as TwoDimensionalArrayDemo.java. Compile and execute 
the program. Figure 9-14 shows a typical execution. As the user continues 
to enter row and column values, the appropriate elements in the array are 465 
incremented. 











Command Prompt 


C:\Java>java TwoDimensionalfrrayDemo 
row or 99 to quit > @ 
column > @ 


row or 99 to quit 
column 


row or 99 to quit 
column > @ 


row or 99 to quit 
column > 5 

position selected 
row or 99 to quit 


7 Y,OEoorr,eqgogr 27 E009 a 














Figure 9-14 Typical execution of the TwoDimensionalArrayDemo program 


Using the Arrays Class 


When you fully understand the power of arrays, you will want to use them to store all kinds of 
objects. Frequently, you will want to perform similar tasks with different arrays—for example, 
filling them with values and sorting their elements. Java provides an Arrays Class, which 
contains many useful methods for manipulating arrays. Table 9-2 shows some of the useful 
methods of the Arrays class. For each method listed in the left column of the table, type 
stands for a data type; an overloaded version of each method exists for each appropriate data 
type. For example, there is a version of the sort() method to sort int, double, char, byte, 
float, long, short, and Object arrays. 
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Q You will learn about the Object class in the chapter Advanced Inheritance Concepts. 


466 





Method Purpose 





static int binarySearch(type [] a, type key) Searches the specified array for the 
specified key value using the binary 
search algorithm 


static boolean equals(type[] a, type[] a2) Returns true if the two specified arrays 
of the same type are equal to one another 


static void fill(type[] a, type val) Assigns the specified value to each 
element of the specified array 

static void sort(type[] a) Sorts the specified array into ascending 
order 

static void sort(type[] a, int fromIndex, Sorts the specified range of the specified 

int toIndex) array into ascending order 


1E))(¥°S4 Useful methods of the Arrays class 


The methods in the Arrays class are static methods, which means you use them with the 
class name without instantiating an Arrays object. The Arrays class is located in the 
java.util package, so you can use the statement import java.util.*; to access it. 

The ArraysDemo application in Figure 9-15 demonstrates how you can use some of the 
methods in the Arrays class. In the ArraysDemo class, the myScores array is created to 
hold five integers. Then, a message and the array reference are passed to a display 
method. The first line of the output in Figure 9-16 shows that the original array is filled 
with Os at creation. After the first display, the Arrays.fi11( method is called in the 

first shaded statement in Figure 9-15. Because the arguments are the name of the array and the 
number 8, when the array is displayed a second time the output is all 8s. In the application, 
two of the array elements are changed to 6 and 3, and the array is displayed again. Finally, 
in the second shaded statement, the Arrays.sort() method is called. The output in 
Figure 9-16 shows that when the display() method executes the fourth time, the array 
elements have been sorted in ascending order. 
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import java.util.*; 
public class ArraysDemo 
{ 
public static void main(String[] args) 
{ 467 
int[] myScores = new int [5]; 
displayC"Original array: myScores) ; 
Arrays.fill(myScores, 8); 
display("After filling with 8s: myScores) ; 
myScores[2] = 6; 
myScores[4] = 3; 
displayC("After changing two values: myScores) ; 
Arrays.sort(myScores) ; 
display("After sorting: myScores) ; 








} 


public static void display(String message, int array[]) 
{ 
int sz = array. length; 
System.out.print (message) ; 
for(int x = 0; x < sz; ++x) 
System.out.print(array[x] +" "); 
System.out.printInQ; 





Figure 9-15 The ArraysDemo application 





fi 


C:\Java>java ArraysDemo 
Original array: 

After filling with 8s: 
After changing two values: 
After sorting: 





NC :\Java> 











Figure 9-16 Output of the ArraysDemo application 
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The Arrays class binarySearch() methods provide convenient ways to search through 
sorted lists of values of various data types. It is important that the list be in order before 
you use it in a call to binarySearch(); otherwise, the results are unpredictable. You do 

not have to understand how a binary search works to use the binarySearch() method, 


but basically the operation takes place as follows: 
468 





e You have a sorted array and an item for which you are searching within the array. 
Based on the array size, you determine the middle position. (In an array with an even 
number of elements, this can be either of the two middle positions.) 


e You compare the item you are looking for with the element in the middle position of 
the array and decide whether your item is above that point in the array—that is, whether 
your item’s value is less than the middle-point value. 


e [fit is above that point in the array, you next find the middle position of the top half of 
the array; if it is not above that point, you find the middle position of the bottom half. 
Either way, you compare your item with that of the new middle position and divide the 
search area in half again. 


e Ultimately, you find the element or determine that it is not in the array. 


a game in which you tried to guess what number someone was thinking, you might have used a similar 


Programmers often refer to a binary search as a “divide and conquer” procedure. If you have ever played 
GY technique. 


Suppose your organization uses six single-character product codes. Figure 9-17 
contains a VerifyCode application that verifies a product code entered by the user. 
The array codes holds six values in ascending order. The user enters a code that is 
extracted from the first String position using the String class charAt() method. 
Next, the array of valid characters and the user-entered character are passed to the 
Arrays.binarySearch() method. If the character is found in the array, its position is 
returned. If the character is not found in the array, a negative integer is returned and 
the application displays an error message. Figure 9-18 shows the program’s execution 
when the user enters K; the character is found in position 2 (the third position) in 
the array. 


equivalent of the array size. In most applications, you do not care about the exact value returned when there 


The negative integer returned by the binarySearch() method when the value is not found is the negative 
Y is no match; you care only whether it is negative. 
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import java.util.*; 
import javax.swing.*; 
public class VerifyCode 
{ 
public static void main(String[] args) 469 
{ 








char[] codes = {'B', 'E', 'K', 'M', 

String entry; 

char usersCode; 

int position; 

entry = JOptionPane.showInputDialog(null, 
"Enter a product code"); 


usersCode = entry.charAt(O); 
position = Arrays.binarySearch(codes, usersCode) ; 
if(position >= 0) 
JOptionPane.showMessageDialog(null, "Position of " + 
usersCode + " is " + position); 
else 
JOptionPane.showMessageDialog(null, usersCode + 
"is an invalid code"); 








Enter a product code @ Position of Kis 2 


Ik 








Figure 9-18 Typical execution of the Veri fyCode application 


results by writing many fewer instructions than if you had to write the methods yourself. This does not mean 
you wasted your time reading about sorting and searching methods earlier in this chapter. The more 
completely you understand how arrays can be manipulated, the more useful, efficient, and creative your 
future applications will be. 


Q The sortQ and binarySearch() methods in the Arrays class are very useful and allow you to achieve 
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Using the Arrays Class 


1. The Arrays class contains methods for manipulating arrays, such as 
binarySearch(), fi110, and sortQ. 


2. You can use the Arrays class binarySearch() method successfully on 
any array as soon as you have assigned values to the array elements. 


3. The binarySearch(Q) method works by continuously deciding whether the 
element sought is above or below the halfway point in sublists of the 
original list. 
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<a You Do It 


Using Arrays Class Methods 


In this section, you create an application that demonstrates several Arrays 
class methods. The application will allow the user to enter a menu of entrees 
that are available for the day at a restaurant. Then, the application will present 
the menu to the user, allow a request, and indicate whether the requested item 
is on the menu. 
1. Open anew file in your text editor, and type the import statements 

you need to create an application that will use the JOptionPane and 

the Arrays Classes: 

import java.util.*; 

import javax.swing.*; 


2. Add the first few lines of the MenuSearch application class: 


public class MenuSearch 


{ 
public static void main(String[] args) 


4 


(continues) 


(continued) 


3. Declare an array to hold the day’s menu choices; the user is allowed to enter 
up to 10 entrees. Also declare two Strings—one to hold the user’s current 
entry and the other to accumulate the entire menu list as it is entered. The 471 
two String variables are initialized to empty Strings using quotation marks; 
if you do not initialize these Strings, you receive a compiler error because 
you might attempt to display them without having entered a legitimate value. 
Also, declare an integer to use as a subscript for the array, another to hold 
the number of menu items entered, and a third to hold the highest allowable 
subscript, which is 1 less than the array size: 








String[] menuChoices = new String[10]; 


String entry= "", menuString = ""; 
int x = 0; 


int numEntered; 
int highestSub = menuChoices.length - 1; 


4. Use the Arrays.fi110© method to fill the menu array with z characters, as 
shown in the following line of code. You use this method so that when you 
perform a search later, actual values will be stored in any unused menu 
positions. If you ignore this step and fill less than half the array, your 
search method might generate an error. 


Arrays.fill(menuChoices, "zzzzzzz"); 


Lowercase zs were purposely chosen as the array fill characters because 
they have a higher value than any other letter. Therefore, when the user’s 
entries are sorted, the zzzzzzz entries will be at the bottom of the list. 


5. Display an input dialog box into which the user can enter a menu item. Allow 
the user to quit before entering 10 items by typing “zzz”. (Using a value such 
as “zzz” is a common programming technique to check for the user’s desire 
to stop entering data. If the data items are numeric instead of text, you might 
use a value such as 999. Values the user enters that are not “real” data, but 
just signals to stop, are often called dummy values.) After the user enters 
the first menu item, the application enters a loop that continues to add the 
entered item to the menu list, increase the subscript, and prompt for a new 
menu item. The loop continues while the user has not entered “zzz” and the 
subscript has not exceeded the allowable limit. When the loop ends, save the 
number of menu items entered: 


(continues) 
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(continued) 


menuChoices[x] = JOptionPane.showInputDialog(nul1, 

"Enter an item for today’s menu, or zzz to quit:"); 
while(!menuChoices[x].equals("zzz") && x < highestSub) 
472 { 





menuString = menuString + menuChoices[x] + "\n"; 
++X} 
if(x < highestSub) 
menuChoices[x] = JOptionPane.showInputDialog(null, 
"Enter an item for today’s menu, or zzz to quit"); 


} 


numEntered = x; 


6. When the menu is complete, display it for the user and allow the user to make 
a request: 


entry = JOptionPane. showInputDialog(null, 
"Today's menu is:\n" + menuString + 
"Please make a selection:"); 


7. Sort the array from index position 0 to numEntered So that it is in ascending 
order prior to using the binarySearch() method. If you do not sort the array, 
the result of the binarySearchQ method is unpredictable. You could sort the 
entire array, but it is more efficient to sort only the elements that hold actual 
menu items: 


Arrays.sort(menuChoices, 0, numEntered) ; 


8. Use the Arrays.binarySearch() method to search for the requested entry 
in the previously sorted array. If the method returns a nonnegative value that 
is less than the numEntered value, display the message “Excellent choice”; 
otherwise, display an error message: 


x = Arrays.binarySearch(menuChoices, entry); 
if( >= 0 && x < numEntered) 
JOptionPane.showMessageDialog(null, "Excellent choice"); 
else 
JOptionPane. showMessageDialog(null, 
"Sorry - that item is not on tonight’s menu"); 


9. Add the closing curly braces for the main® method and the class, and save 
the file as MenuSearch.java. Compile and execute the application. When 
prompted, enter as many menu choices as you want, and enter “zzz” when 
you want to quit data entry. When prompted again, enter a menu choice and 
observe the results. (A choice you enter must match the spelling in the menu 
exactly.) Figure 9-19 shows a typical menu as it is presented to the user, 
and the results after the user makes a valid choice. 


(continues) 
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(continued) 
(ert x | 


[2] Today's menu is: 
Lobster thermidor 
Chicken cordon bleu 
Linguini and clams 
Prime rib 
Roasted pepper medley with wild rice 
Please make a selection: 





473 














Message Px) 
@ Excellent choice 





[Linguini and clams | 



































Figure 9-19 Typical execution of the MenuSearch application 


Using the ArrayList class 


In addition to the Arrays class, Java provides an ArrayList Class that can be used to create 
containers that store lists of objects. The ArrayList class provides some advantages over 
the Arrays class. Specifically, an ArrayList is dynamically resizable, meaning that its size 
can change during program execution. This means that: 


e You can add an item at any point in an ArrayList container, and the array size expands 
automatically to accommodate the new item. 


e You can remove an item at any point in an ArrayList container, and the array size 
contracts automatically. 


To use the ArrayList class, you must use one of the following import statements: 


import java.util.ArrayList; 
import java.util.*; 


Then, to declare an ArrayList, you can use the default constructor, as in the following 
example: 


ArrayList names = new ArrayListQ); 


The default constructor creates an ArrayList with a capacity of 10 items. An ArrayList’s 

capacity is the number of items it can hold without having to increase its size. By definition, 
an ArrayList’s capacity is greater than or equal to its size. You can also specify a capacity if 
you like. For example, the following statement declares an ArrayList that can hold 20 names: 


ArrayList names = new ArrayList(20); 
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If you know you will need more than 10 items at the outset, it is more efficient to create an 
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ArrayList with a larger capacity. 


Table 9-3 summarizes some useful ArrayList methods. 


Method 


Purpose 





public void add(Object) 
public void add(int, Object) 


public void removeCint) 


public void setCint, Object) 


Object getCint) 


public int sizeQ 


Adds an item to an ArrayList; the default 
version adds an item at the next available 
location; an overloaded version allows you to 
specify a position at which to add the item 


Removes an item from an ArrayList ata 
specified location 


Alters an item at a specified ArrayList location 


Retrieves an item from a specified location in an 
ArrayList 


Returns the current ArrayList size 


1 )») (=) Useful methods of the ArrayList class 


Q In the chapter Advanced Inheritance Concepts, you will learn that the Object class is the most generic 
Java class. 


To add an item to the end of an ArrayList, you can use the add() method. For example, 
to add the name Abigail to an ArrayList named names, you can make the following 


statement: 


names .add("Abigail"); 


You can insert an item into a specific position in an ArrayList by using an overloaded 
version of the add() method that includes the position. For example, to insert the name 
Bob in the first position of the names ArrayList, you use the following statement: 


names.add(0, "Bob"); 


With each of the methods described in this section, you receive an error message if the 


position number is invalid for the ArrayList. 


As you can see from Table 9-3, you also can alter and remove items from an ArrayList. 
The ArrayList class contains a size() method that returns the current size of the 
ArrayList. Figure 9-20 contains a program that demonstrates each of these methods. 
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import java.util.ArrayList; 
public class ArrayListDemo 
{ 
public static void main(String[] args) 
{ 475 
ArrayList names = new ArrayListQ); 
names.addC("Abigail"); 
display(names) ; 
names.addC("Brian"); 
display(names) ; 
names.add("Zachary") ; 
display(names) ; 
names.add(2, "Christy"); 
display(names) ; 
names. remove(1); 
display(names) ; 
names.set(O, "Annette"); 
display(names) ; 








F 


public static void display(ArrayList names) 


1 


+ names.size()); 


System.out.printInC("\nThe size of the list is 
for(int x = 0; x < names.size(); ++x) 


System.out.printInC"position " + x + " Name: + 


names.get(x)); 





Figure 9-20 The ArrayListDemo program 


program uses unchecked or unsafe operations. You will learn how to eliminate this message in the next 


When you compile the ArrayListDemo program, you receive a compiler warning indicating that the 
GY section. 


In the application in Figure 9-20, an ArrayList is created and Abigail is added to the list. 
The ArrayList is passed to a display() method that displays the current list size and all the 
names in the list. You can see from the output in Figure 9-21 that at this point, the ArrayList 
size is 1, and the array contains just one name. Examine the program in Figure 9-20 along 
with the output in Figure 9-21 so that you understand how the ArrayList is altered as 
names are added, removed, and replaced. 
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Ge Cc d P t 
fay Command Promp ; 


C:\Java>java ArrayList Demo 


The size of the list is 1 
position @ Name: Abigail 
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of the list is 2 
@ Name: Abigail 
1 Name: Brian 


The size of the list is 3 
position @ Name: Abigail 
position 1 Name: Brian 

position 2 Name: Zachary 


The size of the list is 4 
position @ Name: Abigail 
position 1 Name: Brian 
position 2 Name: Christy 
position 3 Name: Zachary 


The size of the list is 3 
position @ Name: Abigail 
position 1 Name: Christy 
position 2 Name: Zachary 


The size of the list is 3 
position @ Name: Annette 
position 1 Name: Christy 
position 2 Name: Zachary 


\GSEUE Dae 








Figure 9-21 Output of the ArrayListDemo program 


You can display the contents of an ArrayList of Strings without looping through 

the values. For example, Figure 9-22 shows an ArrayList named students that the user 
populates interactively. Displaying the array name as shown in the shaded statement 
produces a comma-separated list between square brackets. Figure 9-23 shows a typical 
execution. 
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import javax.swing.*; 
import java.util.ArrayList; 
public class ArrayListDemo2 
{ 
public static void main(String[] args) 477 
{ 








ArrayList students = new ArrayList(); 
String name; 

final int LIMIT = 4; 

for(int x = 0; x < LIMIT; ++x) 


{ 
name = JOptionPane.showInputDialog(null, 
"Enter a student's name"); 
students.add(name) ; 





2 Enter a student's name Enter a student's name 
[arthur [Ben 














Enter a student's name Enter a student's name 








[Chloe [Danielle 











a ArrayList! 
are [Arthur, Chloe, Danielle] 














Figure 9-23 Typical execution of the ArrayListDemo2 application 
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that every class contains a toString() method that converts its objects to Strings; this method is 
used when you display an ArrayList’s name. However, unless you have overridden the toStringQ 
method within a class, the String that is returned by toString) is not very useful. You will learn more 
about writing this method in the chapter Advanced Inheritance Concepts. 


Q You can achieve similar results using the name for ArrayLists of any class type. In Chapter 7, you learned 
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You can sort an ArrayList using the Collections.sort() method and providing the 
ArrayList as the argument—for example: 


Collections.sort(students) ; 


To use this method, you must import the java.uti1.Collections package at the top 
of the file. 


Understanding the Limitations of the ArrayList Class 


An ArrayList can be used to store any type of object reference. In fact, one ArrayList 
can store multiple types. However, this creates two drawbacks: 


e You cannot use an ArrayList to store primitive types such as int, double, or char 
because those types are not references. If you want to work with primitive types, you 
can create an array or use the Arrays class, but you cannot use the ArrayList class. 


e When you want to store ArrayList elements, you must cast them to the appropriate 
reference type before you can do so, or you must declare a reference type in the 
ArrayList declaration. 


For example, if you want to declare a String to hold the first name in the names ArrayList, 
you must make statements such as the following: 


String firstName; 
firstName = (String)names.get(0); 


The cast operator (String) converts the generic returned object from the get() method to a 
String. If you do not perform this cast, you receive an error message indicating that you are 
using incompatible types. (You first learned about the cast operator in Chapter 2.) 


You can eliminate the need to perform a cast with ArrayList objects by specifying the 
type that an ArrayList can hold. For example, you can declare an ArrayList of names 
as follows: 


ArrayList<String> names = new ArrayList<String>() ; 

Creating an ArrayList declaration with a specified type provides several advantages: 

e You no longer have to use the cast operator when retrieving an item from the ArrayList. 
e Java checks to make sure that only items of the appropriate type are added to the list. 


e The compiler warning that indicates your program uses an unchecked or unsafe operation 
is eliminated. 
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Using the ArrayList Class 


1. An advantage of the ArrayList class over the Arrays Class is that an 479 
ArrayList is dynamically resizable. 








2. An advantage of the ArrayList class over the Arrays Class is that it can 
hold multiple object types. 


3. An advantage of the ArrayList class over the Arrays Class is that it can 
hold primitive data types such as int and double. 
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Creating Enumerations 


Data types have a specific set of values. For example, in Chapter 2 you learned that a 
byte cannot hold a value larger than 127 and an int cannot hold a value larger than 
2,147,483,647. You can also create your own data types that have a finite set of legal values. 
A programmer-created data type with a fixed set of values is an enumerated data type. 


In Java, you create an enumerated data type in a statement that uses the keyword enum, an 
identifier for the type, and a pair of curly braces that contain a list of the enum constants, 
which are the allowed values for the type. For example, the following code creates an 
enumerated type named Month that contains 12 values: 


enum Month {JAN, FEB, MAR, APR, MAY, JUN, 
JUL, AUG, SEP, OCT, NOV, DEC}; 


By convention, the identifier for an enumerated type begins with an uppercase letter. 
This convention makes sense because an enumerated type is a class. Also, by convention, 
the enum constants, like other constants, appear in all uppercase letters. The constants 
are not strings and they are not enclosed in quotes; they are Java identifiers. 


After you create an enumerated data type, you can declare variables of that type. For example, 
you might declare the following: 


Month birthMonth; 


You can assign any of the enum constants to the variable. Therefore, you can code a 
statement such as the following: 


birthMonth = Month.MAY; 
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An enumeration type like Month is a class, and its enum constants act like objects instantiated 
from the class, including having access to the methods of the class. These built-in methods 
include the ones shown in Table 9-4. Each of these methods is nonstatic; that is, each is used 
with an enum object. 
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Method Description Example if birthMonth = Month.MAY 
toStringQ) The toStringQ method returns the birthMonth.toString() has the 
name of the calling constant object. value “MAY” 
You can pass birthMonth to printQ 
or printInQ, and it is automatically 
converted to its string equivalent. 
ordinal () The ordinal © method returns an birthMonth.ordinal() is 4 
integer that represents the constant’s 
position in the list of constants. As with 
arrays, the first position is 0. 
equals() The equals() method returns true birthMonth. equals (Month. MAY) 
if its argument is equal to the calling is true 
object's value. birthMonth. equals (Month. NOV) 
is false 
compareTo() The compareTo() method returns a birthMonth. compareTo(Month. JUL) 


negative integer if the calling object's 
ordinal value is less than that of the 
argument, 0 if they are the same, and 
a positive integer if the calling object’s 
ordinal value is greater than that of the 
argument. 


Wel) (9 Some useful nonstatic enum methods 


is negative 

birthMonth. compareTo(Month. FEB) 
is positive 
birthMonth. compareTo (Month. MAY) 
is 0 





Several static methods are also available to use with enumerations. These are used with 
the type and not with the individual constants. Table 9-5 describes two useful static 





methods. 
Method Description Example with Month Enumeration 
valuedf(Q) The valueOf() method accepts a Month. valueOf ("DEC") returns the 
string parameter and returns an DEC enum constant. 
enumeration constant. 
values() The values() method returns an Month. values() returns an array 


array of the enumerated 
constants. 


El) (5s) Some static enum methods 


with 12 elements that contain the enum 
constants. 
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You can declare an enumerated type in its own file, in which case the filename matches the 
type name and has a java extension. You will use this approach in a “You Do It” exercise later 
in this chapter. Alternatively, you can declare an enumerated type within a class but not 
within a method. Figure 9-24 is an application that declares a Month enumeration and 


demonstrates its use. Figure 9-25 shows two typical executions. 
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import java.util.Scanner; 
public class EnumDemo 
{ 
enum Month {JAN, FEB, MAR, APR, MAY, JUN, 
JUL, AUG, SEP, OCT, NOV, DEC}; 


public static void main(String[] args) 
{ 
Month birthMonth; 
String userEntry; 
int position; 
int comparison; 
Scanner input = new Scanner(System. in); 
System.out.printInC"The months are:"); 
for(Month mon : Month.valuesQ) 
System.out.print(mon + " "); 
System.out.printC"\n\nEnter the first three letters of " + 
"your birth month >> "); 


userEntry = input.nextLine() . toUpperCase() ; 
birthMonth = Month.valueOf(userEntry) ; 
System.out.printInC"You entered " + birthMonth) ; 
position = birthMonth.ordinal(); 


System.out.printIn(birthMonth + is in position + position); 
System.out.printInC"So its month number is " + (position + 1)); 
comparison = birthMonth.compareTo(Month. JUN) ; 
if(comparison < 0) 
System.out.printIn(birthMonth + 
"js earlier in the year than " + Month.JUN); 
else 
ifCcomparison > 0) 
System.out.printIn(birthMonth + 
"as later in the year than " + Month.JUN); 
else 
System.out.printIn(birthMonth + " is " + Month.JUN); 





Figure 9-24 The EnumDemo class 
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fr 





fae Command Prompt 


C:\Java>java EnumDemo 
JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOU DEC 


Enter the first three letters of your birth month >> Sep 
482 You entered SEP 

SEP is in position 8 

So its month number is ? 

NSEP is later in the year than JUN 





RAMI EU A RU we ctitttuy i eture) 
JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOU DEC 


fEnter the first three letters of your birth month >> Feb 
You entered FEB 

FEB is in position 1 

So its month number is 2 

FEB is earlier in the year than JUN 





C:\Java> 











Figure 9-25 Two typical executions of the EnumDemo application 


In the application in Figure 9-24, a Month enumeration is declared; in the mainQ method, 
a Month variable is declared in the first shaded statement. The second shaded statement 
uses the enhanced for loop, which you first learned to use with arrays in Chapter 8. 
The enhanced for loop declares a local Month variable named mon that takes on the 
value of each element in the Month. value() array in turn so it can be displayed. 


In the program in Figure 9-24, the user then is prompted to enter the first three letters 
for a month, which are converted to their uppercase equivalents. The third shaded 
statement in the figure uses the valueOf() method to convert the user’s string to an 
enumeration value. The fourth shaded statement gets the position of the month in the 
enumeration list. The last shaded statement compares the entered month to the JUN 
constant. This is followed by an if statement that displays whether the user’s entered 
month comes before or after JUN in the list or is equivalent to it. 


Starting with Java 7, you can use comparison operators with enumeration constants 
instead of using the compareTo() method to return a number. For example, you can 
write the following: 


if(birthMonth < Month. JUN) 
System.out.printIn(birthMonth + 
"as earlier in the year than " + Month.JUN); 


You can use enumerations to control a switch structure. Figure 9-26 contains a class that 
declares a Property enumeration for a real estate company. The program assigns one of the 
values to a Property variable and then uses a switch structure to display an appropriate 
message. Figure 9-27 shows the result. 
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import java.util.Scanner; 
public class EnumDemo2 
{ 
enum Property {SINGLE_FAMILY, MULTIPLE_FAMILY, 
CONDOMINIUM, LAND, BUSINESS}; 
public static void main(String[] args) 483 
{ 








Property propForSale = Property.MULTIPLE_FAMILY; 
switch(propForSale) 
{ 
case SINGLE_FAMILY: 
case MULTIPLE_FAMILY: 
System.out.printIn("Listing fee is 5%"); 
break; 
case CONDOMINIUM: 
System.out.printInC"Listing fee is 6%"); 
break; 
case LAND: 
case BUSINESS: 
System.out.printIn 
C"We do not handle this type of property"); 





Figure 9-26 The EnumDemo2 class 





a 





x8 Command Prompt 2/8 


C:\Java>java EnumDemo2 
Listing fee is 5% 


C:\Java> 





Figure 9-27 Output of the EnumDemo2 application 


Creating an enumeration type provides you with several advantages. For example, the 
Month enumeration improves your programs in the following ways: 


e Ifyou did not create an enumerated type for month values, you could use another type—for 
example, ints or Strings. The problem is that any value could be assigned to an int or 
String variable, but only the 12 allowed values can be assigned to a Month. 


e Ifyou did not create an enumerated type for month values, you could create another 
type to represent months, but invalid behavior could be applied to the values. For example, 
if you used integers to represent months, you could add, subtract, multiply, or divide two 
months, which is not logical. Programmers say using enums makes the values type-safe. 
Type-safe describes a data type for which only appropriate behaviors are allowed. 
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e The enum constants provide a form of self-documentation. Someone reading your 
program might misinterpret what 9 means as a month value, but there is less confusion 
when you use the identifier OCT. 


e As with other classes, you can also add methods and other fields to an enum type. 


484 





ee : 
Eu Watch the video Enumerations. 





Creating Enumerations 


Assume that you have coded the following: 


enum Color {RED, WHITE, BLUE}; 
Color myColor = Color.RED; 


1. The value of myColor.ordinalQ is 1. 
2. The value of myColor.compareTo(Color.RED) is 0. 
3. The value of myColor < Color.WHITE is true. 
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“a You Do It 


Creating Enumerations 
In this section, you create two enumerations that hold colors and car model types. 
You will use them as field types in a Car class and write a demonstration program 
that shows how the enumerations are used. 
1. Open anew file in your text editor, and type the following Color enumeration: 
enum Color {BLACK, BLUE, GREEN, RED, WHITE, YELLOW}; 
2. Save the file as Color.java. 


(continues) 
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(continued) 


3. Open anew file in your text editor, and create the following Model enumeration: 


enum Model {SEDAN, CONVERTIBLE, MINIVAN}; 485 








4. Save the file as Model.java. Next, open a new file in your text editor, and 
start to define a Car class that holds three fields: a year, a model, and a color. 


public class Car 

{ 
private int year; 
private Model model; 
private Color color; 


5. Adda constructor for the car class that accepts parameters that hold the 
values for year, model, and color as follows: 


public CarCint yr, Model m, Color c) 


{ 
year = yr; 
model = m; 
color = c; 
} 


6. Adda displayQ method that displays a Car object’s data, then add a 
closing curly brace for the class. 


public void display() 
{ 


System.out.printIn("Car is a " + year + 
""" + color + " " + model); 


} 
7. Save the file as Car.java. 


8. Open anew file in your text editor, and write a short demonstration 
program that instantiates two Car objects and assigns values to them 
using enumeration values for the models and colors. 


public class CarDemo 
{ 
public static void main(String[] args) 
{ 
Car firstCar = new Car(2009, Model .MINIVAN, Color.BLUE); 
Car secondcar = new Car(2011, Model .CONVERTIBLE, 
Color.RED) ; 
firstCar.displayQ; 
secondcar.displayQ; 


(continues) 
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(continued) 


9. Save the file as CarDemo.java, and then compile and execute it. Figure 9-28 
shows that the values are assigned correctly. 
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r 


fay Command Prompt 


s a 2669 BLUE MINIVAN 
a 2611 RED CONVERTIBLE 








Figure 9-28 Output of the CarDemo program 


} 
Don't Do It 
e Don't forget that the first subscript used with a two-dimensional array represents the row 
and that the second subscript represents the column. 
e Don't try to store primitive data types in an ArrayList structure. 


e Don't think enum constants are strings; they are not enclosed in quotes. 





Key Terms 


Sorting is the process of arranging a series of objects in some logical order. 








Ascending order describes the order of objects arranged from lowest to highest value. 
Descending order describes the order of objects arranged from highest to lowest value. 
An algorithm is a process or set of steps that solve a problem. 


A bubble sort is a type of sort in which you continue to compare pairs of items, swapping 
them if they are out of order, so that the smallest items “bubble” to the top of the list, 
eventually creating a sorted list. 
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Chapter Summary iii 


With an insertion sort, you look at each list element one at a time, and if an element is out 
of order relative to any of the items earlier in the list, you move each earlier item down 
one position and then insert the tested element. 


A one-dimensional array or single-dimensional array contains one column of values; you 
access its elements using a single subscript. 487 








Two-dimensional arrays have two or more columns of values, and you must use two 
subscripts to access an element. 


Matrix and table are names used for two-dimensional arrays. 
A ragged array is a two-dimensional array that has rows of different lengths. 
Multidimensional arrays contain two or more dimensions. 


The Java Arrays Class is a built-in class that contains many useful methods for manipulating 
arrays, such as methods to search, fill, compare, and sort arrays. 


Dummy values are values the user enters that are not “real” data; they are just signals to stop 
data entry. 


The ArrayList class provides a dynamically resizable container that stores lists of objects. 
Dynamically resizable describes an object whose size can change during program execution. 


An ArrayList’s capacity is the number of items it can hold without having to increase 
its size. 


An enumerated data type is a programmer-created data type with a fixed set of values. 
The enum constants are the allowed values for an enumerated data type. 


Type-safe describes a data type for which only appropriate behaviors are allowed. 


Chapter Summary 


e Sorting is the process of arranging a series of objects in ascending or descending order. 
With a bubble sort, you continue to compare pairs of items, swapping them if they are out 
of order, so that the smallest items “bubble” to the top of the list, eventually creating a 
sorted list. 















e With an insertion sort, you look at each list element one at a time, and if an element is out 
of order relative to any of the items earlier in the list, you move each earlier item down 
one position and then insert the tested element. 


e You can sort arrays of objects in much the same way that you sort arrays of primitive 
types. The major difference occurs when you make the comparison that determines 
whether you want to swap two array elements. When array elements are objects, you 
usually want to sort based on a particular object field. 
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e An array that you can picture as a column of values, and whose elements you can 


access using a single subscript, is a one-dimensional or single-dimensional array. 
Two-dimensional arrays have both rows and columns. You must use two subscripts 
when you access an element in a two-dimensional array. To declare a two-dimensional 
array, you type two sets of brackets after the array type. 


The Java Arrays class contains many useful methods for manipulating arrays. 
These methods provide ways to easily search, compare, fill, and sort arrays. 


The Java ArrayList class contains useful methods for manipulating dynamically sized 
arrays. You can add objects to, remove objects from, and replace objects in ArrayList 
containers. 


A programmer-created data type with a fixed set of values is an enumerated data type. 
In Java, you create an enumerated data type in a statement that uses the keyword enum, 
an identifier for the type, and a pair of curly braces that contain a list of the enum 
constants, which are the allowed values for the type. 


Review Questions 


1. When you place objects in order beginning with the object with the highest value, 


you are sorting in ________ order. 
a. acquiescing c. demeaning 
b. ascending d. descending 


2. Using a bubble sort involves 

comparing parallel arrays 

comparing each array element to the average 

comparing each array element to the adjacent array element 


ao F PS 


swapping every array element with its adjacent element 


3. When you use a bubble sort to perform an ascending sort, after the first pass 
through an array the largest value is 

at the beginning of the list 

in the middle of the list 

at the end of the list 


It is impossible to determine the answer without more information. 


oo F PS 
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Review Questions iii 


4, When you use a bubble sort to perform an ascending sort, after the first pass 
through an array the smallest value is 
at the beginning of the list 
in the middle of the list 
at the end of the list 489 
It is impossible to determine the answer without more information. 


ao Ff PS 








5. When array elements are objects, you usually want to sort based on a 


particular ________ of the object. 
a. field c. name 
b. method d. type 
6. The following defines a array: 
intl] []nums={{1, 2}, {3, 4}, {5, 6}}; 
a. one-dimensional c. three-dimensional 
b. two-dimensional d._ six-dimensional 


7. How many rows are contained in the following array? 


double[][] prices = {{2.56, 3.57, 4.58, 5.59}, 
{12.35, 13.35, 14.35, 15.00}}; 


a 1 c 4 
be 2 d. 8 
8. How many columns are contained in the following array? 


double[][] prices = {{2.56, 3.57, 4.58, 5.59}, 
{12.35, 13.35, 14.35, 15.00}}; 


a 1 c 4 
b. 2 d. 8 


9. In the following array, what is the value of code[2][1]? 









char[][] code = {{ 'A', 'D', 'M ‘}, 


fo" Pe, "'R', 'S "th, 
Ue”, a ar 'Z "hh; 
a. 'P' c. ‘U' 
b. 'R' d. 'v' 
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10. 


11. 


12, 


13. 


14. 


15: 


In the following array, what is the value of address[1] [1]? 


String address = {{ "123 Oak ", "345 Elm "}, 
{ "87 Maple ", "901 Linden "}}; 


a. "123 Oak " c. "87 Maple " 
b. "345 Elm" d. "901 Linden " 


In the following array, what is the value of fees. length? 


double[][] fees = {{3.00, 3.50, 4.00, 5.00}, 
{6.35, 7.35, 8.35, 9.003}; 


a 2 c. 8 
b. 4 d. none of the above 


In the following array, what is the value of fees[1]. length? 


double[][] fees = {{3.00, 3.50, 4.00, 5.00}, 
{6.35, 7.35, 8.35, 9.003}; 


a 2 c. 8 
b. 4 d. none of the above 
You place _________ after the data type in the parameter list of a method 


that receives a two-dimensional array. 


a. a pair of empty brackets 
two pairs of empty brackets 


a pair of brackets that contain the number of rows followed by a pair of 
empty brackets 


d. a pair of empty brackets followed by brackets that contain the number of 


columns 
A array has rows of different lengths. 
a. ragged c. haggard 
b. jagged d. tattered 


If the value of credits[0]. length is not equal to credits[1].length, you 
know credits is 


a. a three-dimensional array c. a partially populated array 
b. an uninitialized array d. a jagged array 
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16. Which of the following is true if a successfully running program contains the 
following statement: 


Arrays. fill(tax, 10); 


a. tax is a two-dimensional array. c. tax is an array with 10 elements. 
b. £1110 is a nonstatic method. d. none of the above 491 








17. Which of the following is a requirement when you use a binary search method 
with an array? 

The array must be numeric. 

The array must have been sorted in ascending order. 

The array must have at least three elements. 


ao Ff PS 


none of the above 


18. The chief advantage to using the ArrayList class instead of the Arrays class is 
that an ArrayList 

can be much larger 

is easier to search 

is dynamically resizable 


ao Ff SP 


can be used as an argument to a static method 


19. The chief disadvantage to using the ArrayList class instead of the Arrays class is 
that an ArrayList 
a. cannot be sorted 
b. cannot store primitive data types 
c. cannot be accessed using subscripts 
d. All of the above are disadvantages to using an ArrayList. 


20. An advantage to using an enumerated data type is 


a. errors are reduced because only a limited set of values can be used with 
the type 
b. time is saved because programs with enumerated types compile faster 








c. coding time is reduced because enumerated types are created automatically 
by the compiler 


d. All of the above are true. 
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Programming Exercises 





492 1. Write an application containing an array of 10 String values, and display them 
in ascending order. Save the file as SortStrings.java. 





2. a. The mean ofa list of numbers is its arithmetic average. The median of a list is its 
middle value when the values are placed in order. For example, if a list contains 
1, 4, 7, 8, and 10, then the mean is 6 and the median is 7. Write an application 
that allows you to enter five integers and displays the values, their mean, and 
their median. Save the file as MeanMedian.java. 


b. Revise the MeanMedian class so that the user can enter any number of 
values up to 20. If the list has an even number of values, the median is the 
numeric average of the values in the two middle positions. Save the file as 
MeanMedian2.java. 


3. a. Radio station JAVA wants a class to keep track of recordings it plays. Create 
a class named Recording that contains fields to hold methods for setting and 
getting a Recording’s title, artist, and playing time in seconds. Save the file as 
Recording.java. 


b. Write an application that instantiates five Recording objects and prompts 
the user for values for the data fields. Then prompt the user to enter which 
field the Recordings should be sorted by—song title, artist, or playing time. 
Perform the requested sort procedure, and display the Recording objects. 
Save the file as RecordingSort.java. 


4, In Chapter 8, you created a Salesperson class with fields for an ID number and 
sales values. Now, create an application that allows a user to enter values for an 
array of seven Salesperson objects. Offer the user the choice of displaying the 
objects in order by either ID number or sales value. Save the application as 
SalespersonSort.java. 


5. In Chapter 8, you created a Salesperson class with fields for an ID number and 
sales values. Now, create an application that allows you to store an array that 
acts as a database of any number of Salesperson objects up to 20. While the 
user decides to continue, offer three options: to add a record to the database, 
to delete a record from the database, or to change a record in the database. 
Then proceed as follows: 












e Ifthe user selects the add option, issue an error message if the database is full. 
Otherwise, prompt the user for an ID number. If the ID number already exists 
in the database, issue an error message. Otherwise, prompt the user for a sales 
value, and add the new record to the database. 
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e Ifthe user selects the delete option, issue an error message if the database is 
empty. Otherwise, prompt the user for an ID number. If the ID number does 
not exist, issue an error message. Otherwise, do not access the record for any 
future processing. 


e Ifthe user selects the change option, issue an error message if the database is 493 
empty. Otherwise, prompt the user for an ID number. If the requested record 
does not exist, issue an error message. Otherwise, prompt the user for a new 
sales value, and change the sales value for the record. 








After each option executes, display the updated database in ascending order by 
Salesperson ID number, and prompt the user to select the next action. Save the 
application as SalespersonDatabase.java. 


6. Write an application that stores at least four different course names and meeting 
days and times in a two-dimensional array. Allow the user to enter a course name 
(such as “CIS 110”), and display the day of the week and time that the course is 
held (such as “Th 3:30”). If the course does not exist, display an error message. 
Save the file as Schedule.java. 


7. a. Table 9-6 shows the various services offered by a hair salon, including its prices 
and times required: 





Service Description Price (S$) Time (Minutes) 
Cut 8.00 15 . 
Shampoo 4.00 10 
Manicure 18.00 30 

Style 48.00 55 
Permanent 18.00 35 

Trim 6.00 5 


Wels) Salon services, prices, and times 














Create a class that holds the service description, price, and number of 
minutes it takes to perform the service. Include a constructor that requires 
arguments for all three data fields and three get methods that each return 
one of the data field’s values. Save the class as Service.java. 


b. Write an application named SalonReport that contains an array to hold six 
Service objects, and fill it with the data from Table 9-6. Include methods to 
sort the array in ascending order by each of the data fields. Prompt the user for 
the preferred sort order, and display the list of services in the requested order. 
Save the program as SalonReport.java. 
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8. Create an application that contains an enumeration that represents the days 
of the week. Display a list of the days, then prompt the user for a day. Display 
business hours for the chosen day. Assume that the business is open from 11 to 
5 on Sunday, 9 to 9 on weekdays, and 10 to 6 on Saturday. Save the file as 


DayOfWeek.java. 
494 





9. Create a class named Majors that includes an enumeration for the six majors offered 
by a college as follows: ACC, CHEM, CIS, ENG, HIS, PHYS. Display the enumeration 
values for the user, then prompt the user to enter a major. Display the college division 
in which the major falls. ACC and CIS are in the Business Division, CHEM and PHYS 
are in the Science Division, and ENG and HIS are in the Humanities Division. Save 
the file as Majors.java. 


10. Create a class named AppointmentKeeper that stores a two-dimensional String 
array with 31 rows and 24 columns. The program allows a user to choose a day 
and an hour continuously and then to enter a String value that describes an 
appointment. After the user finishes entering data, prompt the user continuously 
to enter a day, and show the 24 appointment slots for the day. Save the file as 
AppointmentKeeper.java. Figure 9-29 shows part of a typical execution. 


i 
Nothing scheduled 
Nothing scheduled 
Breakfast meeting with staff 
Nothing scheduled 
Nothing scheduled 
Haircut 
Nothing scheduled 
Nothing scheduled 
Lunch with Sally 
Conference call to San Francisco 
Nothing scheduled 
Nothing scheduled 
Nothing scheduled 
Dinner at Mom and 
Nothing scheduled 
Nothing scheduled 
Nothing scheduled 
Nothing scheduled 
Nothing scheduled 


a. 
a. 
a. 
a. 
a. 
a. 
a. 
p.- 
p.- 
p. 
p. 
p. 
p. 
p. 
p. 
p.- 
p. 
p. 
p. 


Enter a day to see what is scheduled, or 99 to quit >> 














Figure 9-29 Part of a typical execution of the AppointmentKeeper program 
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a Debugging Exercises 


1. Each of the following files in the Chapter09 folder in your downloadable 
student files has syntax and/or logic errors. In each case, determine the 
problem and fix the program. After you correct the errors, save each file 495 
using the same filename preceded with Fix. For example, DebugNinel java 
will become FixDebugNinel java. 








a. DebugNinel.java 
b. DebugNine2.java 
c. DebugNine3 java 
d. DebugNine4.java 
e. Movie.java, which is used by DebugNine2.java. 


Ce, Game Zone 


1. Create a guessing game called “Does It Have Legs?”, in which you think of an animal 
and the computer tries to guess what it is. The game continually becomes “smarter” 
as you play because you teach it how to become more specific with its questions. 
For example, a typical game session might proceed as follows: 

Computer: Does the animal you are thinking of have legs? 
Player: Yes. 

Computer: Is it a dog? 

Player: Yes. 

Computer: Yay! I win. Do you want to play again? 

Player: Yes. 

Computer: Does the animal you are thinking of have legs? 
Player: Yes. 

Computer: Is it a dog? 











Player: No. 

Computer: | give up. What was your animal? 

Player: Horse. 

Computer: Type a question for which the answer is Yes for Dog but No for Horse. 
Player: Does it live in the house? 

Computer: Do you want to play again? 

Player: Yes. 

Computer: Does the animal you are thinking of have legs? 

Player: Yes. 
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2. 


Computer: Does it live in the house? 

Player: No. 

Computer: Is it a Horse? 

Player: No. 

Computer: I give up. What was your animal? 

Player: Cow. 

Computer: Type a question for which the answer is Yes for Horse but No for Cow. 
Player: Do people ride it? 

Computer: Do you want to play again? 

Player: Yes. 

Computer: Does the animal you are thinking of have legs? 
Player: Yes. 

Computer: Does it live in the house? 

Player: No. 

Computer: Do people ride it? 

Player: No. 

Computer: Is it a Cow? 

Player: Yes. 

Computer: Yay! I win. Do you want to play again? 

Player: No. 


(Hint: You might want to look up “binary trees” on the Internet as a method to 
organize this application.) 


Save the application as DoesItHaveLegs.java. 


a. Create a Tic-Tac-Toe game. In this game, two players alternate placing 
Xs and Os into a grid until one player has three matching symbols in a row, 
either horizontally, vertically, or diagonally. Create a game in which the user 
is presented with a three-by-three grid containing the digits 1 through 9. 
When the user chooses a position by typing a number, place an X in the 
appropriate spot. Generate a random number for the position where the 
computer will place an O. Do not allow the player or the computer to place 
a symbol where one has already been placed. Figure 9-30 shows the first 
four windows in a typical game. When either the player or computer has 
three symbols in a row, declare a winner; if all positions have been exhausted 
and no one has three symbols in a row, declare a tie. Save the game as 
TicTacToe.java. 
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Enter the position where you want to play 
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Welcome to Tic Tac Toe. 
You will have X and the computer will have 0 














Your move is recorded; The computer has played 
now the computer will play 
| 12x 
12x 450 
456 789 
789 





Figure 9-30 Typical game of TicTacToe in progress 


b. In the TicTacToe application, the computer’s selection is chosen randomly. 
Improve the TicTacToe game so that when the computer has two Os in any 
row, column, or diagonal, it selects the winning position for its next move 
rather than selecting a position randomly. Save the improved game as 
TicTacToe2.java. 


3. In Chapter 8, you created an application class named Ful1Deck that implemented 
a 52-element array that represented each card in a standard deck of playing cards. 
Now, create an enumeration that holds the four suits: SPADES, HEARTS, DIAMONDS, 
and CLUBS. Save the enumeration in a file named Suit.java. Modify the Card 
class from Chapter 8 to use the enumeration, and save the class as Card2.java. 
Modify the FullDeck application to use the new Card class, and save the 
application as FullDeck2.java. 









4, In Chapter 7, you improved a Rock Paper Scissors game played between a user 
and the computer. Add an enumeration that holds three values that represent 
ROCK, PAPER, and SCISSORS, and use it for all comparisons in the program. Save 
the file as RockPaperScissors3.java. 
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Q. Case Problems 


In the last chapter, you modified the EventDemo program for Carly’s Catering 
498 to accept and display data for an array of three Event objects. Now, modify 
the program to use an array of eight Event objects. Prompt the user to choose 
an option to sort Events in ascending order by event number, number of guests, 
or event type. Display the sorted list and continue to prompt the user for sorting 
options until the user enters a sentinel value. Save the file as EventDemo.java. 





2. In the last chapter, you modified the RentalDemo program for Sammy’s Seashore 
Supplies to accept and display data for an array of three Rental objects. Now, 
modify the program to use an array of eight Rental objects. Prompt the user to 
choose an option to sort Rentals in ascending order by contract number, price, or 
equipment type. Display the sorted list and continue to prompt the user for sorting 
options until the user enters a sentinel value. Save the file as RentalDemo.java. 
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Inheritance 


In this chapter, you will: 


Learn about the concept of inheritance 
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Extend classes 
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Override superclass methods 
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Learn which methods you cannot override 
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CHAPTER 10 Introduction to Inheritance 


Learning About the Concept of Inheritance 


In Java and all object-oriented languages, inheritance is a mechanism that enables one class 

to acquire all the behaviors and attributes of another class and then to expand on those 

features. Inheritance is the principle that allows you to apply your knowledge of a general 
500 category to more specific objects. A class can inherit all the attributes of an existing class, 
meaning that you can create a new class simply by indicating the ways in which it differs 
from a class that has already been developed and tested. 





You are familiar with the concept of inheritance from all sorts of nonprogramming situations. 
When you use the term inheritance, you might think of genetic inheritance. You know 
from biology that your blood type and eye color are the product of inherited genes; you 
can say that many facts about you—your attributes, or “data fields’—are inherited. Similarly, 
you often can credit your behavior to inheritance. For example, your attitude toward 
saving money might be the same as your grandmother’s, and the odd way that you pull 

on your ear when you are tired might match what your Uncle Steve does—thus, your 
methods are inherited, too. 


You also might choose plants and animals based on inheritance. You plant impatiens next 
to your house because of your shady street location; you adopt a Doberman Pinscher because 
you need a watchdog. Every individual plant and pet has slightly different characteristics, 
but within a species, you can count on many consistent inherited attributes and behaviors. 
Similarly, the classes you create in object-oriented programming languages can inherit data 
and methods from existing classes. When you create a class by making it inherit from another 
class, you are provided with data fields and methods automatically. 


Diagramming Inheritance Using the UML 


Beginning with the first chapter of this book, you have been creating classes and instantiating 
objects that are members of those classes. Programmers and analysts sometimes use a 
graphical language to describe classes and object-oriented processes; this Unified Modeling 
Language (UML) consists of many types of diagrams. UML diagrams can help illustrate 
inheritance. 


For example, consider the simple Employee class shown in Figure 10-1. The class contains 
two data fields, empNum and empSal, and four methods: a get and set method for each field. 
Figure 10-2 shows a UML class diagram for the Employee class. A class diagram is a 

visual tool that provides you with an overview of a class. It consists of a rectangle divided into 
three sections—the top section contains the name of the class, the middle section contains 
the names and data types of the attributes, and the bottom section contains the methods. 
Only the method return type, name, and arguments are provided in the diagram—the 
instructions that make up the method body are omitted. 
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Employee 
-empNum : int 
-empSal : double 


public class Employee 

{ 
private int empNum; 
private double empSal; 
public int getEmpNum() 
{ 


My 


ais seule gerenpsal Figure 10-2 The Employee class diagram 


t+getEmpNum : int 
+getEmpSal : double 501 
+setEmpNum(int num) : void 

+setEmpSal(double sal) : void 








return empNum; 





return empSal; 


} 


public void setEmpNumCint num) 


{ 


empNum = num; 


public void setEmpSal(double sal) 
{ 


} 


empSal = sal; 





Figure 10-1 The Employee class 


By convention, a class diagram contains the data type following each attribute or method, as shown in 
Figure 10-2. A minus sign ( — ) is inserted in front of each private field or method, and a plus sign ( + ) 
is inserted in front of each public field or method. 


Commonly, UML diagram creators refrain from using Java terminology such as int in a class diagram. 
Instead, they might use a more general term, such as integer. The Employee class is designed in 
natural language (English) and might be implemented in any programming language, and languages other 
than Java might use a different keyword to designate integer variables. Because you are studying Java, 
this book uses the Java keywords in diagrams. For more information on UML, you can go to the Object 
Management Group’s Web site at www.omg.org. OMG is an international, nonprofit computer industry 
consortium. 


G 
G 


After you create the Employee class, you can create specific Employee objects, such as the 
following: 


Employee receptionist = new Employee(); 
Employee deliveryPerson = new Employee(); 


These Employee objects can eventually possess different numbers and salaries, but 
because they are Employee objects, you know that each Employee has some number 
and salary. 
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Suppose that you hire a new type of Employee named serviceRep, and that a serviceRep 
object requires not only an employee number and a salary but also a data field to indicate 
territory served. You can create a class with a name such as EmployeeWithTerritory 
and provide the class three fields (empNum, empSal, and empTerritory) and six methods 
(get and set methods for each of the three fields). However, when you do this, you are 
duplicating much of the work that you have already done for the Employee class. The 
wise, efficient alternative is to create the class EmployeeWithTerritory so it inherits all 
the attributes and methods of Employee. Then, you can add just the one field and two 
methods that are new within EmployeeWithTerritory objects. Figure 10-3 shows a class 
diagram of this relationship. In a UML diagram, an inheritance relationship is indicated 
with an arrow that points from the descendant class to the original class. 


Employee 


-empNum : int 
-empSal : double 


t+getEmpNum : int 

+getEmpSal : double 
+setEmpNum(int num) : void 
+setEmpSal(double sal) : void 


Emp loyeeWithTerritory 
-empTerritory : int 


+getEmpTerritory : int 
+setEmpTerritory(int territory) : void 





Figure 10-3 Class diagram showing the relationship between Employee and 
Emp loyeeWithTerritory 


When you use inheritance to create the EmployeeWithTerritory class, you: 
e Save time because the Employee fields and methods already exist 
e Reduce errors because the Employee methods already have been used and tested 


e Reduce the amount of new learning required to use the new class, because you 
have used the Employee methods on simpler objects and already understand how 
they work 


The ability to use inheritance in Java makes programs easier to write, less error prone, and 
more quickly understood. Besides creating EmployeeWithTerritory, you also can create 
several other specific Employee classes (perhaps EmployeeEarningCommission, including a 
commission rate, or DismissedEmployee, including a reason for dismissal). By using 
inheritance, you can develop each new class correctly and more quickly. The concept of 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce! earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 





Learning About the Concept of Inheritance D0 


inheritance is useful because it makes a class’s code more easily reusable. Each defined 
data field and each method already written and tested in the original class becomes part 
of the new class that inherits it. 


named Calendar. 


Q In Chapter 4, you learned about the GregorianCalendar class. It descends from a more general class 


Inheritance Terminology 


A class that is used as a basis for inheritance, such as Employee, is a base class. When 
you create a class that inherits from a base class (such as EmployeeWithTerritory), it is 
a derived class. When considering two classes that inherit from each other, you can tell 
which is the base class and which is the derived class by using the two classes in a 
sentence with the phrase “is a(n).” A derived class always “is a” case or example of the 
more general base class. For example, a Tree class can be a base class to an Evergreen 
class. An Evergreen “is a” Tree, so Tree is the base class; however, it is not true for all 
Trees that “a Tree is an Evergreen.” Similarly, an EmployeeWithTerritory “is an” 
Employee—but not the other way around—so Employee is the base class. 


object’s reference to a base class reference. Similarly, if a method accepts a base class object reference, 
it also will accept references to its derived classes. The next chapter describes these concepts in 
greater detail. 


Q Because a derived class object “is an” instance of the base class, too, you can assign a derived class 


Do not confuse “is a” situations with “has a” situations. For example, you might create a 
Business class that contains an array of Department objects; in turn, each Department object 
might contain an array of Employee objects. You would not say “A department is a business” 
but that “a business has departments.” Therefore, this relationship is not inheritance; it is 
composition—the relationship in which a class contains one or more members of another 
class, when those members would not continue to exist without the object that contains 
them. (For example, if a Business closes, its Departments do, too.) Similarly, you would not 
say “an employee is a department” but that “a department has employees.” This relationship 
is not inheritance either; it is a specific type of composition known as aggregation—the 
relationship in which a class contains one or more members of another class, when those 
members would continue to exist without the object that contains them. (For example, if a 
business or department closed, the employees would continue to exist.) 


You can use the terms superclass and subclass as synonyms for base class and derived class, 
respectively. Thus, Evergreen can be called a subclass of the Tree superclass. You can also 
use the terms parent class and child class. An EmployeeWithTerritory is a child to the 
Employee parent. Use the pair of terms with which you are most comfortable; all of these 
terms are used interchangeably throughout this book. 
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As an alternative way to discover which of two classes is the base class or subclass, you can 
try saying the two class names together. When people say their names together, they state 
the more specific name before the all-encompassing family name, as in “Ginny Kroening.” 
Similarly, with classes, the order that “makes more sense” is the child-parent order. 
“Evergreen Tree” makes more sense than “Tree Evergreen,” so Evergreen is the child class. 
504 





Finally, you usually can distinguish superclasses from their subclasses by size. Although 
it is not required, in general a subclass is larger than a superclass because it usually has 
additional fields and methods. A subclass description might look small, but any subclass 
contains all the fields and methods of its superclass, as well as the new, more specific 
fields and methods you add to that subclass. 


ee 
Eau Watch the video Inheritance. 


Learning About the Concept of Inheritance 
1. When you use inheritance in Java, you can create a new class that contains 
all the data and methods of an existing class. 
When you use inheritance, you save time and reduce errors. 


A class that is used as a basis for inheritance is called a subclass. 


"ssejouadns e WOod} 
S}UaUUl JY} SSeID e SI SSejOqns Y “SSe|D Juased JO ‘ssejo aseq ‘ssejduadns e 
payed si adueayul JO} SIseq e Se pasn SI je} SSelD Y “E# SI JUaWAa}e}S sje} aul 


Extending Classes 


You use the keyword extends to achieve inheritance in Java. For example, the following 
class header creates a superclass-subclass relationship between Employee and 
Emp loyeeWithTerritory: 


public class EmployeeWithTerritory extends Employee 


Each EmployeeWithTerritory automatically receives the data fields and methods of the 
superclass Employee; you then add new fields and methods to the newly created subclass. 
Figure 10-4 shows an EmployeeWithTerritory class. 
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public class EmployeeWithTerritory extends Employee 
{ 
private int empTerritory; 
public int getEmpTerritory() 
{ 505 
return empTerritory; 
} 


public void setEmpTerritory(Cint num) 


{ 
} 








empTerritory = num; 





Figure 10-4 The EmployeeWithTerritory class 


You can write a statement that instantiates a derived class object, such as the following: 
EmployeeWithTerritory northernRep = new EmployeeWithTerritory() ; 
Then you can use any of the next statements to get field values for the northernRep object: 


northernRep.getEmpNum() ; 
northernRep.getEmpSal Q ; 
northernRep.getEmpTerritoryQ( ; 


The northernRep object has access to all three get methods—two methods that it inherits 
from Employee and one method that belongs to EmployeeWithTerritory. 


Similarly, after the northernRep object is declared, any of the following statements are legal: 


northernRep.setEmpNum(915) ; 
northernRep.setEmpSal (210.00) ; 
northernRep.setEmpTerritory(5) ; 


The northernRep object has access to all the parent Employee class set methods, as well as its 
own class’s new set method. 


Inheritance is a one-way proposition; a child inherits from a parent, not the other way 
around. When you instantiate an Employee object, it does not have access to the 
EmployeeWithTerritory methods. It makes sense that a parent class object does not have 
access to its child’s data and methods. When you create the parent class, you do not know 
how many future subclasses it might have or what their data or methods might look like. 


In addition, subclasses are more specific than the superclass they extend. An Orthodontist 
class and Periodontist class are children of the Dentist parent class. You do not expect 
all members of the general parent class Dentist to have the Orthodontist’s applyBraces () 
method or the Periodontist’s deepClean() method. However, Orthodontist objects and 
Periodontist objects have access to the more general Dentist methods conductExam() 
and bil1Patients(). 
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You can use the instanceof operator to determine whether an object is a member or 
descendant of a class. For example, if northernRep is an EmployeewithTerritory object, 
then the value of each of the following expressions is true: 


northernRep instanceof EmployeeWithTerritory 


northernRep instanceof Employee 
506 





If aClerk is an Employee object, then the following is true: 
aClerk instanceof Employee 

However, the following is false: 

aClerk instanceof EmployeeWithTerritory 


Programmers say that instanceof yields true if the operand on the left can be upeast to 
the operand on the right. 





Extending Classes 


1. You use the keyword inherits to achieve inheritance in Java. 
2. A derived class has access to all its parents’ nonprivate methods. 
3. Subclasses are more specific than the superclass they extend. 
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<n You Do It 


Demonstrating Inheritance 


In this section, you create a working example of inheritance. To see the effects of 
inheritance, you create this example in four stages: 


e First, you create a Party class that holds just one data field and three methods. 


e After you create the general Party class, you write an application to demonstrate 
its use. 


e Then, you create a more specific DinnerParty subclass that inherits the fields 
and methods of the Party class. 


e Finally, you modify the demonstration application to add an example using the 


DinnerParty Class. (continues) 
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(continued) 
Creating a Superclass and an Application to Use It 
1. Open anew file in your text editor, and enter the following first few lines for — 
a simple Party class. The class hosts one integer data field—the number of fhadd | 


guests expected at the party: 


public class Party 
{ 


private int guests; 
2. Add the following methods that get and set the number of guests: 


public int getGuests() 
{ 


} 
public void setGuests(Cint numGuests) 


{ 


} 
3. Adda method that displays a party invitation: 


return guests; 


guests = numGuests; 


public void displayInvitationQ) 
{ 


} 


4. Add the closing curly brace for the class, and then save the file as 
Party.java. Compile the class; if necessary, correct any errors and 
compile again. 


System.out.printInC("Please come to my party!"); 


Writing an Application That Uses the party Class 


Now that you have created a class, you can use it in an application. A very simple 
application creates a Party object, prompts the user for the number of guests at 
the party, sets the data field, and displays the results. 


1. Open a new file in your text editor. 


2. Write a UseParty application that has one method—a main() method. 
Enter the beginning of the class, including the start of the main® method, 
which declares a variable for guests, a Party object, and a Scanner object 
to use for input: 


(continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce: earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 





CHAPTER 10 Introduction to Inheritance 


Ec 


4. 


(continued) 


import java.util.*; 
public class UseParty 
{ 
public static void main(String[] args) 
{ 
int guests; 
Party aParty = new PartyQ; 
Scanner keyboard = new Scanner(System. in) ; 


Continue the main® method by prompting the user for a number of guests 
and accepting the value from the keyboard. Set the number of guests in the 
Party object, and then display the value: 


System.out.print("Enter number of guests for the party >> "); 
guests = keyboard.nextintQ); 
aParty.setGuests(guests) ; 
System.out.printInC"The party has 


+ aParty.getGuests() + " guests"); 


Add a statement to display the party invitation, and then add the closing curly 
braces for the main® method and for the class: 


aParty.displayInvitationQ ; 
} 
} 


Save the file as UseParty.java, then compile and run the application. 
Figure 10-5 shows a typical execution. 


fy Command Prompt 


i 


C:\Java>java UseParty 
Enter number of guests for the party >> 26 
The party has 26 guests 


Please come to my party? 


C:\Java> 








Figure 10-5 Execution of the UseParty application 


Creating a Subclass from the Party Class 


Next, you create a class named DinnerParty. A DinnerParty “is a” type of Party 
at which dinner is served, SO DinnerParty is a child class of Party. 


(continues) 
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(continued) 


1. Open anew file in your text editor, and type the first few lines for the 
DinnerParty Class: 


public class DinnerParty extends Party 509 | 
. 7 


2. ADinnerParty contains a number of guests, but you do not have to define 
the variable here. The variable is already defined in Party, which is the 
superclass of this class. You need to add only any variables that are particular 
to a DinnerParty. Enter the following code to add an integer code for the 
dinner menu choice: 


private int dinnerChoice; 


3. The Party class already contains methods to get and set the number of 
guests, SO DinnerParty needs methods only to get and set the dinnerChoice 
variable as follows: 


public int getDinnerChoice() 
{ 


return dinnerChoice; 


public void setDinnerChoiceCint choice) 


{ 


} 
4. Save the file as DinnerParty.java, and then compile it. 


dinnerChoice = choice; 


Creating an Application That Uses the DinnerParty Class 
Now you can modify the UseParty application so that it creates a DinnerParty as 
well as a plain Party. 
1. Open the UseParty.java file in your text editor. Change the class name to 
UseDinnerParty. Immediately save the file as UseDinnerParty.java. 
2. Include a new variable that holds the dinner choice for a DinnerParty: 
int choice; 


3. After the statement that constructs the Party object, type the following 
DinnerParty object declaration: 


DinnerParty aDinnerParty = new DinnerPartyQ; 


(continues) 
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(continued) 


4. Atthe end of the main® method, after the party object data and invitation 
are displayed, add a prompt for the number of guests for the DinnerParty. 
| 510 Accept the value the user enters and assign it to the object. Even though 
the DinnerParty Class does not contain a setGuests() method, its parent 
class does, SO aDinnerParty can use the method. 


System.out.print("Enter number of guests for the dinner party >> "); 
guests = keyboard.nextintQ); 
aDinnerParty.setGuests (guests) ; 


5. Next, prompt the user for a dinner choice. To keep this example simple, 
the program provides only two choices and does not provide range 
checking. Accept a response from the user, assign it to the object, and 
then display all the data for the DinnerParty. Even though the DinnerParty 
class does not contain a getGuests() method, its parent class does, so 
aDinnerParty Can use the method. The DinnerParty class uses its own 
setDinnerChoice() and getDinnerChoice() methods. 


System.out.print 
C'Enter the menu option -- 1 for chicken or 2 for beef >> "); 

choice = keyboard.nextIint() ; 

aDinnerParty.setDinnerChoice(choice) ; 

System.out.printIn("The dinner party has " + 
aDinnerParty.getGuests() + " guests"); 

System.out.printIn("Menu option " + 
aDinnerParty.getDinnerChoice () + 


will be served"); 


6. Add astatement to call the displayInvitation(@ method with the 
DinnerParty object. Even though the DinnerParty class does not contain 
a displayInvitation() method, its parent class does, sO aDinnerParty 
can use the method. 


aDinnerParty.displayInvitationQ ; 


7. Save the file, compile it, and run it using values of your choice. Figure 10-6 
shows a typical execution. The DinnerParty object successfully uses 
the data field and methods of its superclass, as well as its own data field 
and methods. 


(continues) 
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(continued) 


| 
; 2 511 
C:\Java>java UseDinnerParty 


Enter number of guests for the party >> 26 

The party has 26 guests 

Please come to my party? 

Enter number of guests for the dinner party >> 8 

Enter the menu option —- 1 for chicken or 2 for beef >> 1 





The dinner party has 8 guests 
served 
sPlease come to my party? 


Cz\Java> 








Figure 10-6 Execution of the UseDinnerParty application 


Overriding Superclass Methods 


When you create a subclass by extending an existing class, the new subclass contains data 
and methods that were defined in the original superclass. In other words, any child class 
object has all the attributes of its parent. Sometimes, however, the superclass data fields 
and methods are not entirely appropriate for the subclass objects; in these cases, you want 
to override the parent class members. 


When you use the English language, you often use the same method name to indicate diverse 
meanings. For example, if you think of MusicalInstrument as a class, you can think of playO 
as a method of that class. If you think of various subclasses such as Guitar and Drum, you 
know that you carry out the play() method quite differently for each subclass. Using the 
same method name to indicate different implementations is called polymorphism, a term 
meaning “many forms’—many different forms of action take place, even though you use 
the same word to describe the action. In other words, many forms of the same word exist, 
depending on the object associated with the word. 


You first learned the term polymorphism in Chapter 1. Polymorphism is one of the basic principles of 


™~ 
hp object-oriented programming. If a programming language does not support polymorphism, the language 
LZ is not considered object oriented. 


For example, suppose that you create an Employee superclass containing data fields such 
as firstName, lastName, socialSecurityNumber, dateOfHire, rateOfPay, and so on, and 
the methods contained in the Employee class include the usual collection of get and set 
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methods. If your usual time period for payment to each Employee object is weekly, your 
displayRateOfPay() method might include a statement such as: 


System.out.printInC"Pay is " + rateOfPay + " per week "); 


Imagine your company has a few Employees who are not paid weekly. Maybe some are paid 
512 by the hour, and others are Employees whose work is contracted on a job-to-job basis. 
Because each Employee type requires different paycheck-calculating procedures, you might 
want to create subclasses of Employee, such as HourlyEmployee and ContractEmployee. 





When you call the displayRateOfPay() method for an HourlyEmployee object, you 

want the display to include the phrase “per hour”, as in “Pay is $8.75 per hour.” When you 
call the displayRateOfPay() method for a ContractEmployee, you want to include “per 
contract”, as in “Pay is $2000 per contract.” Each class—the Employee superclass and the 
two subclasses—requires its own displayRateOfPay() method. Fortunately, if you create 
separate displayRateOfPay() methods for each class, the objects of each class use the 
appropriate method for that class. When you create a method in a child class that has 
the same name and parameter list as a method in its parent class, you override the method 
in the parent class. When you use the method name with a child object, the child’s 
version of the method is used. 


It is important to note that each subclass method overrides any method in the parent class 
that has both the same name and parameter list. If the parent class method has the same 
name but a different parameter list, the subclass method does not override the parent class 
version; instead, the subclass method overloads the parent class method, and any subclass 
object has access to both versions. You learned about overloading methods in Chapter 4. 
You first saw the term override in Chapter 4, when you learned that a variable declared 
within a block overrides another variable with the same name declared outside the block. 


If you could not override superclass methods, you could always create a unique name for 
each subclass method, such as displayRateOfPayForHourly(), but the classes you create are 
easier to write and understand if you use one reasonable name for methods that do essentially 
the same thing. Because you are attempting to display the rate of pay for each object, 
displayRateOfPay() is a clear and appropriate method name for all the object types. 


A child class object can use an overridden parent’s method by using the keyword super. You will learn 
GY about this word later in this chapter. 


Object-oriented programmers use the term polymorphism when discussing any operation 
that has multiple meanings. For example, the plus sign ( + ) is polymorphic because it 
operates differently depending on its operands. You can use the plus sign to add integers 

or doubles, to concatenate strings, or to indicate a positive value. As another example, 
methods with the same name but different parameter lists are polymorphic because the 
method call operates differently depending on its arguments. When Java developers refer 

to polymorphism, they most often mean subtype polymorphism—the ability of one method 
name to work appropriately for different subclass objects of the same parent class. 
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—) Watch the video Handling Methods and Inheritance. 


Overriding Superclass Methods 








1. Any child class object has all the attributes of its parent, but all of those 
attributes might not be directly accessible. 


2. You override a parent class method by creating a child class method with 
the same identifier but a different parameter list or return type. 


3. When a child class method overrides a parent class method, and you use the 
method name with a child class object, the child class method version executes. 
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<a You Do It 


Overriding a Superclass Method 


In the previous “You Do It” section, you created Party and DinnerParty Classes. 
The DinnerParty Class extends Party and so can use its displayInvitation() 
method. Suppose that you want a DinnerParty object to use a specialized invitation. 
In this section, you override the parent class method so that the same method name 
acts uniquely for the child class object. 


1. Open the DinnerParty.java class in your text editor. Change the class name 
to DinnerParty2, and save the file as DinnerParty2.java. 


2. Create a displayInvitation() method that overrides the parent class 
method with the same name as follows: 


public void displayInvitation() 
{ 


} 
3. Save the class and compile it. 


System.out.printIn("'Please come to my dinner party!"); 


(continues) 
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4. 


a 


(continued) 


Open the UseDinnerParty.java file. Change the class name to 
UseDinnerParty2, and immediately save the file as UseDinnerParty2.java. 


Change the declaration of the aDinnerParty object so that it uses the 
DinnerParty2 Class as a data type and DinnerParty2 as the constructor name. 


Save the class, compile it, and execute it. Figure 10-7 shows a typical 
execution. Each type of object uses its own version of the 
displayInvitation() method. 


fae Command Prompt 


C:\Java>java UseDinnerPart y2 

Enter number of guests for the party >> 40 

The party has 46 guests 

Please come to my party? 

Enter number of guests for the dinner party >> 6 

Enter the menu option —- 1 for chicken or 2 for heef >> 2 
The dinner party has 6 guests 

Menu option 2 will be served 

Please come to my dinner party? 


C=:\Java> 








Figure 10-7 Typical execution of the UseDinnerParty2 program 


Calling Constructors During Inheritance 


When you create any object, as in the following statement, you are calling a class 
constructor method that has the same name as the class itself: 


SomeClass anObject = new SomeClass(); 


When you instantiate an object that is a member of a subclass, you are actually calling at least 


two constructors: the constructor for the base class and the constructor for the extended, 


derived class. When you create any subclass object, the superclass constructor must execute 


first, and then the subclass constructor executes. 
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In the chapter Advanced Inheritance Concepts, you will learn that every Java object automatically is a child 


of a class named Object. So, when you instantiate any object, you call its constructor and Object’s 
constructor, and when you create parent and child classes of your own, the child classes use three 
constructors. 
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Calling Constructors During Inheritance 9) 


When a superclass contains a default constructor and you instantiate a subclass object, 
the execution of the superclass constructor is transparent—that is, nothing calls attention 
to the fact that the superclass constructor is executing. However, you should realize that 
when you create an object such as the following (where HourlyEmployee is a subclass of 
Employee), both the Employee() and HourlyEmployee() constructors execute: 


HourlyEmployee clerk = new HourlyEmployee() ; 515 








For example, Figure 10-8 shows three classes. The class named ASuperClass has a 
constructor that displays a message. The class named ASubClass descends from 
ASuperClass, and its constructor displays a different message. The DemoConstructors 
class contains just one statement that instantiates one object of type ASubClass. 


public class ASuperClass 
{ 
public ASuperClass(Q) 
{ 


} 


System.out.printInC"In superclass constructor") ; 


} 
public class ASubClass extends ASuperClass 
{ 

public ASubClass() 

{ 


ts 


System.out.printInC"In subclass constructor") ; 


} 
public class DemoConstructors 


{ 


public static void main(String[] args) 


{ 
} 


ASubClass child = new ASubClassQ); 





Figure 10-8 Three classes that demonstrate constructor calling when a subclass object is 
instantiated 


Figure 10-9 shows the output when DemoConstructors executes. You can see that when 
DemoConstructors instantiates the ASubClass object, the parent class constructor executes 
first, displaying its message, and then the child class constructor executes. Even though only 
one object is created, two constructors execute. 
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a 
Command Prompt S| E 





C:\Java>java DemoConstructors 
superclass constructor 
In subclass constructor 


C:\Java> 





Figure 10-9 Output of the DemoConstructors application 


Of course, most constructors perform many more tasks than displaying a message to 
inform you that they exist. When constructors initialize variables, you usually want the 
superclass constructor to take care of initializing the data fields that originate in the 
superclass. Usually, the subclass constructor only needs to initialize the data fields that 
are specific to the subclass. 


Using Superclass Constructors That Require Arguments 


When you create a class and do not provide a constructor, Java automatically supplies 

you with a default constructor—one that never requires arguments. When you write your 
own constructor, you replace the automatically supplied version. Depending on your needs, 
a constructor you create for a class might be a default constructor or might require 
arguments. When you use a class as a superclass and the class has only constructors that 
require arguments, you must be certain that any subclasses provide the superclass 
constructor with the arguments it needs. 


Don't forget that a class can have many constructors. As soon as you create at least one constructor for 
a class, you can no longer use the automatically supplied version. 





When a superclass has a default constructor, you can create a subclass with or without 
its own constructor. This is true whether the default superclass constructor is the 
automatically supplied one or one you have written. However, when a superclass contains 
only constructors that require arguments, you must include at least one constructor for 
each subclass you create. Your subclass constructors can contain any number of statements, 
but if all superclass constructors require arguments, then the first statement within each 
subclass constructor must call one of the superclass constructors. When a superclass 
requires constructor arguments upon object instantiation, even if you have no other reason 
to create a subclass constructor, you must write the subclass constructor so it can call its 
superclass’s constructor. 


If a superclass has multiple constructors but one is a default constructor, you do not have 
to create a subclass constructor unless you want to. If the subclass contains no constructor, 
all subclass objects use the superclass default constructor when they are instantiated. 
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The format of the statement that calls a superclass constructor from the subclass 
constructor is: 


super(Jist of arguments) ; 


The keyword super always refers to the superclass of the class in which you use it. 
517 





If a superclass contains only constructors that require arguments, you must create a 
subclass constructor, but the subclass constructor does not necessarily have to have 
parameters of its own. For example, suppose that you create an Employee class with a 
constructor that requires three arguments—a character, a double, and an integer—and 
you create an HourlyEmployee class that is a subclass of Employee. The following code 
shows a valid constructor for HourlyEmp1oyee: 





public HourlyEmployee() 


{ 
super(‘P’, 12.35, 40); 
// Other statements can go here 


} 


This version of the HourlyEmployee constructor requires no arguments, but it passes 
three constant arguments to its superclass constructor. A different, overloaded version 
of the HourlyEmployee constructor can require arguments. It could then pass the 
appropriate arguments to the superclass constructor. For example: 


public HourlyEmployee(char dept, double rate, int hours) 
{ 


super(dept, rate, hours); 
// Other statements can go here 


} 


Except for any comments, the super() statement must be the first statement in any 
subclass constructor that uses it. Not even data field definitions can precede it. Although 
it seems that you should be able to use the superclass constructor name to call the 
superclass constructor—for example, Employee ()—Java does not allow this. You must 
use the keyword super. 


you learned that you can call a base class constructor from a derived class using super (). However, 
you cannot use both this() and super) in the same constructor because each is required to be the 
first statement in any constructor in which it appears. 


Q In Chapter 4, you learned that you can call one constructor from another using this(). In this chapter, 


ee 
ju Watch the video Constructors and Inheritance. 
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Calling Constructors During Inheritance 


518 1. When you create any subclass object, the subclass constructor executes 
first, and then the superclass constructor executes. 


2. When constructors initialize variables, you usually want the superclass 
constructor to initialize the data fields that originate in the superclass and 
the subclass constructor to initialize the data fields that are specific to the 
subclass. 


3. When a superclass contains only nondefault constructors, you must include 
at least one constructor for each subclass you create. 
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<a You Do It 


Understanding the Role of Constructors in Inheritance 


Next, you add a constructor to the Party class. When you instantiate a subclass 
object, the superclass constructor executes before the subclass constructor 
executes. 


1. Open the Party.java file in your text editor, and save it as 
PartyWithConstructor.java. Change the class name to 
PartyWithConstructor. 


2. Following the statement that declares the guests data field, type a 
constructor that does nothing other than display a message indicating it 
is working: 


public PartyWithConstructor() 
{ 


} 
3. Save the file and compile it. 


System.out.printInC"Creating a Party"); 


(continues) 
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(continued) 


4. \nyour text editor, open the DinnerParty2.java file, and change the class name 
to DinnerPartyWithConstructor. Change the class in the extends clause to 
PartyWithConstructor. Save the file as DinnerPartyWithConstructor.java, 519 | 
and compile it. 


5. In your text editor, open a new file so you can write an application to 
demonstrate the use of the base class constructor with an extended 
class object. This application creates only one child class object: 


public class UseDinnerPartyWithConstructor 


{ 
public static void main(String[] args) 
{ 
DinnerPartyWithConstructor aDinnerParty = 
new DinnerPartyWithConstructor() ; 
} 
} 


6. Save the application as UseDinnerPartyWithConstructor.java, then 
compile and run it. The output is shown in Figure 10-10. Even though the 
application creates only one subclass object (and no superclass objects) and 
the subclass contains no constructor of its own, the superclass constructor 
executes. 


fa 


C:\Java>java UseDinnerPart yWithConstructor 
Creating a Party 








| EMIEVE D2 





Figure 10-10 Output of the UseDinnerPartyWithConstructor application 


Inheritance When the Superclass Requires Constructor Arguments 
Next, you modify the PartywithConstructor Class so that its constructor requires an 
argument. Then, you observe that a subclass without a constructor cannot compile. 


1. Open the PartyWithConstructor.java file in your text editor, and then change 
the class name to PartyWithConstructor2. 


(continues) 
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(continued) 


2. Replace the existing constructor with a new version using the new class name. 
This constructor requires an argument, which it uses to set the number of 


| 520 guests who will attend a party: 


public PartyWithConstructor2(Cint numGuests) 
{ 


} 
3. Save the file as PartyWithConstructor2.java, and then compile it. 
4. Open the DinnerPartyWithConstructor.java file in your text editor. 


5. Change the class header as follows so that the name of the class is 
DinnerPartyWithConstructor2 and it inherits from PartywithConstructor2 


guests = numGuests; 


public class DinnerPartyWithConstructor2 extends 
PartyWithConstructor2 


6. Save the file as DinnerPartyWithConstructor2.java, and then compile it. 
An error message appears, as shown in Figure 10-11. When you attempt to 
compile the subclass, no parameterless constructor can be found in the 
superclass, so the compile fails. 


fe Command Prompt 


C:\Java>javac DInnerPart yWithConstructor2. java 

DInnerPart yWithConstructor2.java:1: error: constructor PartyWithConstructor2 in 
class PartyWithConstructor2 cannot be applied to given types; 

public class DinnerPartyWithConstructor2 extends PartyWithConstructor2 


required: int 

found: no arguments 

reason: actual and formal argument lists differ in length 
1 error 


IC =\Java> 








Figure 10-11 Error message generated when compiling the 
DinnerPartyWithConstructor2 class 


7. To correct the error, open the DinnerPartyWithConstructor2.java file in your 
text editor. Following the dinnerChoice field declaration, insert a constructor for 
the class as follows: 


public DinnerPartyWithConstructor2(Cint numGuests) 


{ 
} 


super (numGuests) ; 


(continues) 
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(continued) 


8. Save the file and compile it. This time, the compile is successful because 
the subclass calls its parent’s constructor, passing along an integer value. 
Note that the DinnerPartywithConstructor2 subclass constructor is not 521 
required to receive an integer argument, although in this example it does. 
For example, it would be acceptable to create a subclass constructor that 
required no arguments but passed a constant (for example, 0) to its parent. 
Similarly, the subclass constructor could require several arguments and pass 
one of them to its parent. The requirement is not that the subclass constructor 
must have the same number or types of parameters as its parent; the only 
requirement is that the subclass constructor calls super© and passes to the 
parent what it needs to execute. 





Accessing Superclass Methods 


Earlier in this chapter, you learned that a subclass can contain a method with the same 
name and arguments (the same signature) as a method in its parent class. When this happens, 
using the subclass method overrides the superclass method. However, instead of overriding 
the superclass method, you might want to use it within a subclass. If so, you can use the 
keyword super to access the parent class method. 


For example, examine the Customer class in Figure 10-12 and the PreferredCustomer 

class in Figure 10-13. A Customer has an idNumber and balanceOwed. In addition to these 
fields, a PreferredCustomer receives a discountRate. In the PreferredCustomer display() 
method, you want to display all three fields—idNumber, balanceOwed, and discountRate. 
Because two-thirds of the code to accomplish the display has already been written for the 
Customer class, it is convenient to have the PreferredCustomer display() method use 

its parent’s version of the display() method before displaying its own discount rate. 

Figure 10-14 shows a brief application that displays one object of each class, and Figure 10-15 
shows the output. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Cei earning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 10 Introduction to Inheritance 


522 





public class Customer 


{ 


private int idNumber; 

private double balanceOwed; 

public Customer(Cint id, double bal) 
{ 


idNumber = id; 


balanceOwed = bal; 
} 
public void displayQ 
{ 
System.out.printInC"Customer #" + idNumber + 
" Balance $" + balanceQwed) ; 





Figure 10-12 The Customer class 


public class PreferredCustomer extends Customer 


{ 





double discountRate; 
public PreferredCustomer(int id, double bal, double rate) 
{ 

super(id, bal); 

discountRate = rate; 
} 
public void display() 
{ 

super.displayQ; 

System.out.printin¢c" Discount rate is 


+ discountRate) ; 


Figure 10-13 The PreferredCustomer class 


public class TestCustomers 


1 


public static void main(String[] args) 
{ 
Customer oneCust = new Customer(124, 123.45); 


PreferredCustomer onePCust = new 
PreferredCustomer(125, 3456.78, 0.15); 

oneCust.displayQ ; 

onePCust.displayQ; 





Figure 10-14 The TestCustomers application 
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@ 
a 


C:\Java>java TestCustomers 

Customer #124 Balance $123.45 

Customer #125 Balance $3456.78 
Discount rate is 6.15 


: ; ae ss . 323 i 








Figure 10-15 Output of the TestCustomers application 


When you call a superclass constructor from a subclass constructor, the call must be 
the first statement in the constructor. However, when you call an ordinary superclass 
method within a subclass method, the call is not required to be the first statement in 
the method, although it can be, as shown in the display( method in Figure 10-13. 


Comparing this and super 


In a subclass, the keywords this and super sometimes refer to the same method, but 
sometimes they do not. 


For example, if a subclass has overridden a superclass method named someMethod(), 
then within the subclass, super.someMethod() refers to the superclass version of the 
method, and both someMethod() and this.someMethod() refer to the subclass version. 


On the other hand, if a subclass has not overridden a superclass method named someMethod(), 
the child can use the method name with super (because the method is a member of the 
superclass), with this (because the method is a member of the subclass by virtue of 
inheritance), or alone (again, because the method is a member of the subclass). 





Accessing Superclass Methods 


1. You can use the keyword this from within a derived class method to access 
an overridden base class method. 


2. You can use the keyword super from within a derived class method to 
access an overridden base class method. 


3. You can use the keyword super from within a derived class method to access 
a base class method that has not been overridden. 
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Employing Information Hiding 


The Student class shown in Figure 10-16 is an example of a typical Java class. Within the 
Student class, as with most Java classes, the keyword private precedes each data field, 
and the keyword public precedes each method. In fact, the four get and set methods are 
524 public within the Student class specifically because the data fields are private. Without 
the public get and set methods, there would be no way to access the private data fields. 








public class Student 
{ 








private int idNum; 
private double gpa; 
public int getIdNumQ) 
{ 


return idNum; 


} 
public double getGpa() 
{ 


} 
public void setIdNumCint num) 
{ 


} 
public void setGpaCdouble gradePoint) 
{ 


} 


return gpa; 


idNum = num; 


gpa = gradePoint; 





Figure 10-16 The Student class 


When an application is a client of the Student class (that is, it instantiates a Student 
object), the client cannot directly alter the data in any private field. For example, 
suppose that you write a main() method that creates a Student as: 


Student someStudent = new Student(); 
Then you cannot change the Student’s idNum with a statement such as: 


: Don't Do It 
someStudent.idNum = 812; You cannot access a private 


data member of an object. 





The idNum of the someStudent object is not accessible in the main method that uses the 
Student object because idNum is private. Only methods that are part of the Student class 
itself are allowed to alter private Student data. To alter a Student’s idNum, you must use 
a public method, as in the following: 


someStudent.setIdNum(812) ; 
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The concept of keeping data private is known as information hiding. When you employ 
information hiding, your data can be altered only by the methods you choose and only 
in ways that you can control. For example, you might want the setIdNum() method to 
check to make certain the idNum is within a specific range of values. If a class other than 
the Student class could alter idNum, idNum could be assigned a value that the Student 


class couldn’t control. 52 


You first learned about information hiding and using the public and private keywords in Chapter 3. 
GY You might want to review these concepts. 


When a class serves as a superclass to other classes you create, your subclasses inherit 

all the data and methods of the superclass. The methods in a subclass can use all of the 
data fields and methods that belong to its parent, with one exception: private members 
of the parent class are not accessible within a child class’s methods. If a new class could 
simply extend your Student class and get to its data fields without going through the proper 
channels, information hiding would not be operating. 


default. Such base class members cannot be accessed within a child class unless the two classes are in 


If the members of a base class don’t have an explicit access specifier, their access is package by 
GY the same package. You will learn about packages in the next chapter. 


Sometimes, you want to access parent class data from within a subclass. For example, 
suppose that you create two child classes—PartTimeStudent and FullTimeStudent—that 
extend the Student class. If you want the subclass methods to be able to directly access 
idNum and gpa, these data fields cannot be private. However, if you don’t want other, 
nonchild classes to access these data fields, they cannot be public. To solve this problem, 
you can create the fields using the specifier protected. Using the keyword protected 
provides you with an intermediate level of security between public and private access. 
If you create a protected data field or method, it can be used within its own class or in 
any classes extended from that class, but it cannot be used by “outside” classes. In other 
words, protected members are those that can be used by a class and its descendants. 


You seldom are required to make parent class fields protected. A child class can access 
its parent’s private data fields by using public methods defined in the parent class, just 
as any other class can. You need to make parent class fields protected only if you want 
child classes to be able to access private data directly. (For example, perhaps you do not 
want a parent class to have a get method for a field, but you do want a child class to be able 
to access the field. As another example, perhaps a parent class set method enforces limits on 
a field’s value, but a child class object should not have such limits.) Using the protected 
access specifier for a field can be convenient, and it also improves program performance 
because a child class can use an inherited field directly instead of “going through” methods 
to access the data. However, protected data members should be used sparingly. Whenever 
possible, the principle of information hiding should be observed, so even child classes 
should have to go through public methods to “get to” their parent’s private data. When 
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child classes are allowed direct access to a parent’s fields, the likelihood of future errors 
increases. Classes that directly use fields from parent classes are said to be fragile because 
they are prone to errors—that is, they are easy to “break.” 


Employing Information Hiding 


1. Information hiding describes the concept of keeping data private. 


2. A subclass inherits all the data and methods of its superclass, except the 
private ones. 


3. If a data field is defined as protected, then a method in a child class can use 
it directly. 
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Methods You Cannot Override 


Sometimes when you create a class, you might choose not to allow subclasses to override 
some of the superclass methods. For example, an Employee class might contain a method 
that calculates each Employee’s ID number based on specific Employee attributes, and 
you might not want any derived classes to be able to provide their own versions of this 
method. As another example, perhaps a class contains a statement that displays legal 
restrictions to using the class. You might decide that no derived class should be able to 
display a different version of the statement. 


The three types of methods that you cannot override in a subclass are: 
e static methods 
e final methods 


e Methods within final classes 


A Subclass Cannot Override static Methods in Its Superclass 


A subclass cannot override methods that are declared static in the superclass. In other 
words, a subclass cannot override a class method—a method you use without instantiating 
an object. A subclass can hide a static method in the superclass by declaring a static 
method in the subclass with the same signature as the static method in the superclass; 
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then, you can call the new static method from within the subclass or in another class 
by using a subclass object. However, this static method that hides the superclass static 
method cannot access the parent method using the super object. 


Figure 10-17 shows a Basebal1Player class that contains a single static method named 
showOrigins(). Figure 10-18 shows a ProfessionalBasebal1Player class that extends the 
Basebal1Player class to provide a salary. Within the ProfessionalBasebal1Player class, 
an attempt is made to create a nonstatic method that overrides the static showOrigins() 
method to display the general Abner Doubleday message about baseball from the parent 
class as well as the more specific message about professional baseball. However, the compiler 
returns the error message shown in Figure 10-19—you cannot override a static method 
with a nonstatic method. 


527 








public class Basebal1Player 


{ 


private int jerseyNumber; 
private double battingAvg; 
public static void showOrigins() 


{ uw 


System.out.printInC"Abner Doubleday is often " + 
"credited with inventing baseball"); 





Figure 10-17 The Basebal1Player class 


public class ProfessionalBasebal1Player extends Basebal1Player 
t x 
double salary; Don't Do It 


A é ae A nonstatic method cannot 
a Ne VOAG showorigins() override a static member 


of a parent class. 


super.showOriginsQ); 
System.out.printInC"The first professional + 
“major league baseball game was played in 1871"); 





Figure 10-18 The ProfessionalBasebal1Player class attempting to override the parent's 
static method 
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java 
howOrigins¢> in ProfessionalBaseballP 
ballPlayer 


overridden method is static 
| 528 1 error 
iC =\Java> 








Figure 10-19 Error message when compiling the ProfessionalBasebal1Player class 
in Figure 10-18 


Figure 10-20 shows a second version of the ProfessionalBasebal1Player class. In this 
version, the showOrigins() method has been changed to static in an attempt to fix the 
problem in Figure 10-19. Figure 10-21 shows the error message that appears when this class 
is compiled. Because this method version is static, the method is not used with an object 
and does not receive a this reference. The keyword super can be used in child class, 
nonstatic, and instance methods and constructors, but not in child class static methods. 





public class ProfessionalBaseballPlayer extends Basebal1Player 








{ 
eubYs Sater F = Don't Do It 
public static void showOrigins() You cannot refer to super 
{ a in a static method. 
super.showOriginsQ); 
System.out.printInC"The first professional " + 
"major league baseball game was played in 1871"); 
} 
3 


Figure 10-20 The ProfessionalBasebal1Player class with a static method that attempts to 
reference super 


static variable super cannot be re 


d from a atic context 
super .showOrigins (>; 
a 


1 error 


iC >\Java> 








Figure 10-21 Error message when compiling the ProfessionalBasebal1Player class in 
Figure 10-20 
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Finally, Figure 10-22 shows a ProfessionalBasebal1Player class that compiles without 
error. The class extends Basebal1Player, and its showOrigins() method is static. 
Because this method has the same name as the parent class method, when you use 
the name with a child class object, this method hides the original. However, it cannot 
use the super keyword to access the Abner Doubleday method. If you want the 
Professional Basebal1Player class to display information about baseball in general as 529 
well as professional baseball in particular, you can do either of the following: 








e You can repeat the parent class message within the child class using a printInO 
statement. 


e You can use the parent class name, a dot, and the method name. Although a child 
class cannot inherit its parent’s static methods, it can access its parent’s static 
methods the same way any other class can. The shaded statement in Figure 10-22 
uses this approach. 


Figure 10-23 shows a class that creates a ProfessionalBasebal1Player and tests the 
method; Figure 10-24 shows the output. 


public class ProfessionalBasebal1lPlayer extends Basebal1Player 


t 


double salary; 
public static void showOrigins() 
{ 
Basebal1Player.showOrigins() ; 
System.out.printInC"The first professional " + 
“major league baseball game was played in 1871"); 





Figure 10-22 The ProfessionalBasebal1Player class 


public class TestProPlayer 


{ 


public static void main(String[] args) 


{ 


ProfessionalBasebal1lPlayer aYankee = 
new ProfessionalBasebal1Player(); 
aYankee.showOrigins() ; 


ty 





Figure 10-23 The TestProPlayer class 
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Abner Doubleday often credited with inventing baseball 
The first professional major league baseball game was played in 1871 


C=\Java> 








Figure 10-24 Output of the TestProPlayer application 


A Subclass Cannot Override final Methods in Its Superclass 


A subclass cannot override methods that are declared final in the superclass. For 
example, consider the Basketbal1Player and ProfessionalBasketbal1Player 
classes in Figures 10-25 and 10-26, respectively. When you attempt to compile the 
ProfessionalBasketbal1Player class, you receive the error message in Figure 10-27, 
because the class cannot override the final displayMessage() method in the 
parent class. 








public class Basketbal1Player 
{ 


private int jerseyNumber; 
public final void displayMessage() 
{ 


System.out.printInC"Michael Jordan is the " + 
"greatest basketball player - and that is final"); 


Figure 10-25 The Basketbal1Player class 








public class ProfessionalBasketbal1lPlayer extends Basketbal1Player 


t Don't Do It 


doub1 il : : 
ropa eee Es A child class method 


public void displayMessage() 


{ cannot override a final 
parent class method. 


System.out.printIn("I have nothing to say"); 
} 


Figure 10-26 The ProfessionalBasketbal1Player class that attempts to override a 
final method 
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Methods You Cannot Override D0 


C=\Java>javac ProfessionalBaskethallPlaye 


ProfessionalBaskethallPlayer.java:4: . displayMe 
letballPlayer cannot override displayMessage(> in Ba 
public void displayMessage (> 


overridden method is final j = 
1 error 531 | 
iC :\Java> | LL = 


Figure 10-27 Error message when compiling the ProfessionalBasketbal1Player class 
in Figure 10-26 


J, If you make the displayMessage() method final in the Professional Basketbal1Player 
GY class in Figure 10-26, you receive the same compiler error message as shown in Figure 10-27. If you 
L make the displayMessage() method static in the ProfessionalBasketbal1Player class, 

the class does not compile, but you do receive an additional error message. 











In Chapter 2, you learned that you can use the keyword final when you want to create a 
constant, as in final double TAXRATE = 0.065;. You can also use the final modifier with 
methods when you don’t want the method to be overridden—that is, when you want every 
child class to use the original parent class version of a method. 


In Java, all instance method calls are virtual method calls by default—that is, the method 
used is determined when the program runs because the type of the object used might not 
be known until the method executes. For example, with the following method you can pass 
in a Basketbal1Player object, or any object that is a child of Basketbal1Player, so the 
“actual” type of the argument bbplayer, and which version of displayMessage() to use, is 
not known until the method executes. 


public void display(Basketbal1lPlayer bbplayer) 
{ 


} 


In other words, the version of the method used is not determined when the program is 
compiled; it is determined when the method call is made. Determining the correct method takes 
a small amount of time. An advantage to making a method final is that the compiler knows 
there is only one version of the method—the parent class version. Therefore, the compiler does 
know which method version to use—the only version—and the program is more efficient. 


bbplayer.displayMessage() ; 


Because a final method’s definition can never change—that is, can never be overridden 
with a modified version—the compiler can optimize a program’s performance by removing 
the calls to final methods and replacing them with the expanded code of their definitions 
at each method call location. This process is called inlining the code. When a program 
executes, you are never aware that inlining is taking place; the compiler chooses to use 
this procedure to save the overhead of calling a method, and the program runs faster. 
The compiler chooses to inline a final method only if it is a small method that contains 
just one or two lines of code. 
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CHAPTER 10 Introduction to Inheritance 


A Subclass Cannot Override Methods in a final Superclass 


You can declare a class to be final. When you do, all of its methods are final, regardless 
of which access specifier precedes the method name. A final class cannot be a parent. 
oe Figure 10-28 shows two classes: a HideAndGoSeekPlayer class that is a final class because 
a 532 | of the word final in the class header, and a ProfessionalHideAndGoSeekP layer class 
that attempts to extend the final class, adding a salary field. Figure 10-29 shows the error 
message generated when you try to compile the ProfessionalHideAndGoSeekPlayer class. 


public final class HideAndGoSeekPlayer 





| { 
private int count; 
public void displayRules() 
{ 
System.out.printInC"You have to count to " + count + 
" before you start looking for hiders"); 
} 
} 
public final class ProfessionalHideAndGoSeekP ayer Don’t Do It 
extends HideAndGoSeekP layer You cannot extend 
{ a final class. 
private double salary; 
} 
| 





iC:\Java>javac ProfessionalHideAndGoSeekPlayer. java 
ProfessionalHideAndGoSeekPlayer.java:2: error: cannot inherit from final HideAnds® 
GoSeekPlayer 

extends HideAndGoSeekPlayer 


1 error 


C2=\Java> 








Figure 10-29 Error message when compiling the ProfessionalHideAndGoSeekP layer class 
in Figure 10-28 


Jp Java's Math class, which you learned about in Chapter 4, is an example of a final class. 
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Methods You Cannot Override 


1. Asubclass cannot override methods that are declared static in the superclass. 533 





A subclass cannot override methods that are declared final in the superclass. 


A subclass cannot override methods that are declared private in the 
superclass. 


*SOQUO po de70UNd JO ILL Gnd 
Se |[aM SC SPOUJOW a7eALUd BPLUBAO UBD SsejDqns VW “E# SI JUBLWS}e}S osje} oy] 


Don't Do It 


e Don't capitalize the o in the instanceof operator. Although the second word in an 
identifier frequently is capitalized in Java, instanceof is an exception. 


e Don't try to directly access private superclass members from a subclass. 


e Don't forget to call a superclass constructor from within a subclass constructor if the 
superclass does not contain a default constructor. 


e Don't try to override a final method in an extended class. 


e Don't try to extend a final class. 





Key Terms 


Inheritance is a mechanism that enables one class to inherit, or assume, both the behavior 
and the attributes of another class. 









The Unified Modeling Language (UML) is a graphical language used by programmers and 
analysts to describe classes and object-oriented processes. 


A class diagram is a visual tool that provides you with an overview of a class. It consists 

of a rectangle divided into three sections—the top section contains the name of the class, the 
middle section contains the names and data types of the attributes, and the bottom section 
contains the methods. 


A base class is a class that is used as a basis for inheritance. 
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A derived class is a class that inherits from a base class. 


Composition is the relationship in which one class contains one or more members of 
another class that would not continue to exist without the object that contains them. 


——— Aggregation is a type of composition in which a class contains one or more members of 
J 534 another class that would continue to exist without the object that contains them. 
| Superclass and subclass are synonyms for base class and derived class. 
Parent class and child class are synonyms for base class and derived class. 
The keyword extends is used to achieve inheritance in Java. 


The instanceof operator determines whether an object that is the operand on the left 
is a member or descendant of the class that is the operand on the right. 


To upcast an object is to change it to an object of a class higher in the object’s inheritance 
hierarchy. 


Polymorphism is the technique of using the same method name to indicate different 
implementations. 


To override a method in a parent class is to create a method in a child class that has the same 
name and parameter list as a method in its parent class. 


Subtype polymorphism is the ability of one method name to work appropriately for different 
subclasses of a parent class. 


The keyword super refers to the parent or superclass of the class in which you use it. 
Information hiding is the concept of keeping data private. 


The keyword protected provides you with an intermediate level of security between public 
and private access. Protected members are those that can be used by a class and 
its descendants. 


Fragile classes are those that are prone to errors. 


Virtual method calls are those in which the method used is determined when the program 
runs, because the type of the object used might not be known until the method executes. 
In Java, all instance method calls are virtual calls by default. 








Inlining the code is an automatic process that optimizes performance. Because a final 
method’s definition can never be overridden, the compiler can optimize a program’s 
performance by removing the calls to final methods and replacing them with the 
expanded code of their definitions at each method call location. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
“4 ight to remove additional content at any time if subsequent rights restrictions require it. 





Chapter Summary iii 


Chapter Summary 
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In Java, inheritance is a mechanism that enables one class to inherit both the behavior 

and the attributes of another class. Using inheritance saves time because the original 

fields and methods already exist, have been tested, and are familiar to users. A class 

that is used as a basis for inheritance is a base class. A class you create that inherits 535 
from a base class is called a derived class. You can use the terms superclass and subclass 

as synonyms for base class and derived class; you can also use the terms parent class 

and child class. 


You use the keyword extends to achieve inheritance in Java. A parent class object 
does not have access to its child’s data and methods, but when you create a subclass 
by extending an existing class, the new subclass contains data and methods that were 
defined in the original superclass. 





Sometimes, superclass data fields and methods are not entirely appropriate for the 
subclass objects. Polymorphism is the act of using the same method name to 
indicate different implementations. You use polymorphism when you override a 
superclass method in a subclass by creating a method with the same name and 
parameter list. 


When you create any subclass object, the superclass constructor must execute first, 

and then the subclass constructor executes. When a superclass contains only constructors 
that require arguments, you must include at least one constructor for each subclass 

you create. Your subclass constructors can contain any number of statements, but the 
first statement within each constructor must call the superclass constructor. When a 
superclass requires parameters upon instantiation, even if you have no other reason to 
create a subclass constructor, you must write the subclass constructor so it can call its 
superclass’s constructor. The format of the statement that calls a superclass constructor 
is super(Jist of arguments);. 


If you want to use a superclass method within a subclass, you can use the keyword 
super to access the parent class method. 


Subclasses inherit all the data and methods of their superclasses, but private members 
of the parent class are not accessible with a child class’s methods. However, if you 
create a protected data field or method, it can be used within its own class or in any 
classes extended from that class, but it cannot be used by “outside” classes. A subclass 
cannot override methods that are declared static in the superclass. A subclass can 
hide a static method in the superclass by declaring a static method in the subclass 
with the same signature as the static method in the superclass. A subclass cannot 
override methods that are declared final in the superclass or methods declared within 
a final class. 








deemed that any suppressed content does not materially affect the overall learning experience. ‘0 remove additif 





CHAPTER 10 Introduction to Inheritance 


Review Questions 


1. A way to discover which of two classes is the base class and which is the subclass 
is to 


536 look at the class size 





try saying the two class names together 
use polymorphism 


a0 F SP 


Both a and b are correct. 


2. Employing inheritance reduces errors because 


the new classes have access to fewer data fields 
the new classes have access to fewer methods 
you can copy methods that you already created 


ao Ff 


many of the methods you need have already been used and tested 


3. A base class can also be called a 


a. child class c. derived class 
b. subclass d. superclass 


4, Which of the following choices is the best example of a parent class/child class 


relationship? 
a. Rose/Flower c. Dog/Poodle 
b. Present/Gift d. Sparrow/Bird 


5. The Java keyword that creates inheritance is 


a. static c. extends 


b. enlarge d. inherits 


6. Aclass named Building has a public, nonstatic method named getFloors(). 
If School is a child class of Building, and modelHigh is an object of type School, 
which of the following statements is valid? 










Building. getFloorsQ; 
School.getFloors(); 
modelHigh.getFloors(); 


ao Ff PS 


All of the previous statements are valid. 
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10. 


11. 


12. 


13. 
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Which of the following statements is true? 


A child class inherits from a parent class. 

A parent class inherits from a child class. 

Both of the preceding statements are true. 

Neither a nor b is true. 537 


ao F SP 





When a subclass method has the same name and argument types as a superclass 


method, the subclass method __________ the superclass method. 
a. overrides c. overloads 
b. overuses d. overcompensates 


When you instantiate an object that is a member of a subclass, the 
constructor executes first. 


a. subclass c. extended class 

b. child class d. parent class 

The keyword super always refers to the ______ of the class in which you 
use it. 

a. child class c. subclass 

b. derived class d. parent class 


If the only constructor in a superclass requires arguments, its subclass 


must contain a constructor 
must not contain a constructor 
must contain a constructor that requires arguments 


aoe 


must not contain a constructor that requires arguments 


If a superclass constructor requires arguments, any constructor of its subclasses 
must call the superclass constructor 

as the first statement 

as the last statement 

at some time 








ao oP 


multiple times if multiple arguments are involved 


A child class Motorcycle extends a parent class Vehicle. Each class constructor 
requires one String argument. The Motorcycle class constructor can call the 
Vehicle class constructor with the statement 


a. VehicleC"Honda") ; c. super ("Suzuki"); 
b. Motorcycle("Harley"); d. none of the above 
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14. 


16. 


17. 


18. 


19. 


20. 
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In Java, the concept of keeping data private is known as 


a. polymorphism c. data deception 
b. information hiding d. concealing fields 
If you create a data field or method that is _________, it can be used within 


its own class or in any classes extended from that class. 


a. public c. private 

b. protected d. both aandb 
Within a subclass, you cannot override ___________ methods. 
a. public c. static 

b. private d. constructor 


You call a static method using 


a. the name of its class, a dot, and the method name 

b. the name of the class’s superclass, a dot, and the method name 

c. the name of an object in the same class, a dot, and the method name 

d. either a or b 

You use a ____________ method access specifier when you create methods for 
which you want to prevent overriding in extended classes. 

a. public c. final 

b. protected d. subclass 

A compiler can decide to ________ a fina method—that is, determine the 
code of the method call when the program is compiled. 

a. duplicate c. redline 

b. inline d. beeline 


When a parent class contains a static method, child classes 
override it. 


a. frequently c. must 
b. seldom d. cannot 
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Exercises 


Programming Exercises 





1. Create a class named Horse that contains data fields for the name, color, and birth 530 
year. Include get and set methods for these fields. Next, create a subclass named {___ 
RaceHorse, which contains an additional field that holds the number of races in which 
the horse has competed and additional methods to get and set the new field. Write an 
application that demonstrates using objects of each class. Save the files as Horse.java, 
RaceHorse.java, and DemoHorses.java. 


2. Mick’s Wicks makes candles in various sizes. Create a class for the business named 
Cand1e that contains data fields for color, height, and price. Create get methods for 
all three fields. Create set methods for color and height, but not for price. Instead, 
when height is set, determine the price as $2 per inch. Create a child class named 
ScentedCandle that contains an additional data field named scent and methods to 
get and set it. In the child class, override the parent’s setHeight() method to set the 
price of a ScentedCand1e object at $3 per inch. Write an application that instantiates 
an object of each type and displays the details. Save the files as Candle.java, 
ScentedCandle.java, and DemoCandles.java. 


3. Create a class named TennisGame that holds data about a single tennis game. The 
class has six fields: the names of the two players, the integer final scores for the 
players, and the String values of the final scores. Include a get method for each of 
the six fields. Also include a set method that accepts two players’ names, and 
another set method that accepts the two integer final score values. The integer final 
score for a player is the number of points the player won during the game; this value 
should be in the range of 0 through 4. If either of the set method parameters for a 
score is not in the range of 0 through 4, assign 0 to both scores and assign “error” to 
the String scores. If both players’ score parameters are 4, assign 0 to both scores 
and “error” to the String scores. The String score values are set by the method that 
sets the integer score values. The String final score for each player contains the 
traditional names for points in tennis: love, 15, 30, 40, or game, respectively, for the 
values 0 through 4. Create a subclass named DoublesTennisGame that includes two 
additional fields for the names of the first two players’ partners. Include get methods 
for the names. Override the parent class setNames() method to accept the names of 
all four players. Write an application named DemoTennisGames that instantiates 
several objects of each of these classes. Demonstrate that all the methods assign 
correct values. Save the files as TennisGame.java, DoublesTennisGame.java, 
and DemoTennisGames.java. 













4, a. Create a class named Year that contains a data field that holds the number of days 
in a year. Include a get method that displays the number of days and a constructor 
that sets the number of days to 365. Create a subclass named LeapYear. 
LeapYear’s constructor overrides Year’s constructor and sets the number of days 
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to 366. Write an application named UseYear that instantiates one object of each 
class and displays their data. Save the files as Year.java, LeapYear.java, and 
UseYear.java. 


b. Adda method named daysElapsed() to the Year class you created in Exercise 4a. 
The daysElapsed() method accepts two arguments representing a month and a 
day; it returns an integer indicating the number of days that have elapsed since 
January 1 of that year. For example, on March 3 in nonleap years, 61 days have 
elapsed (31 in January, 28 in February, and 2 in March). Create a daysElapsed() 
method for the LeapYear class that overrides the method in the Year class. For 
example, on March 3 in a LeapYear, 62 days have elapsed (31 in January, 29 in 
February, and 2 in March). Write an application named UseYear2 that prompts 
the user for a month and day, and calculates the days elapsed in a Year and ina 
LeapYear. Save the files as Year2.java, LeapYear2.java, and UseYear2.java. 


Every summer, Leeland Lakeside resort rents cabins by the week. Create a class 
named CabinRental that includes an integer field for the cabin number and a 
double field for the weekly rental rate. Include get methods for these fields and 

a constructor that requires an integer argument representing the cabin number. 
The constructor sets the weekly rate based on the cabin number; cabins 
numbered 1, 2, and 3 are $950 per week, and others are $1,100 per week. Create 
an extended class named HolidayCabinRental that is used for rentals during weeks 
that include summer holiday weekends. The constructor for this class requires a 
room number and adds a $150 surcharge to the regular rental rate. Write an 
application named DemoCabinRental that creates an object of each class, and 
demonstrate that all the methods work correctly. Save the files as CabinRental.java, 
HolidayCabinRental.java, and DemoCabinRental.java. 


Create a class named Package with data fields for weight in ounces, shipping method, 
and shipping cost. The shipping method is a character: A for air, T for truck, or M 
for mail. The Package class contains a constructor that requires arguments for 
weight and shipping method. The constructor calls a calculateCost() method 
that determines the shipping cost, based on the following table: 








_Weight (02.) Air (S Truck ($) Mail ($) 
1 to 8 2.00 1.50 50 
9 to 16 3.00 2.35 1.50 
17 and over 4.50 3.25 2.15 





The Package class also contains a display() method that displays the values in all 
four fields. Create a subclass named InsuredPackage that adds an insurance cost to 
the shipping cost, based on the following table: 
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Shipping Cost Before Insurance (S$) Additional Cost ($) 
0 to 1.00 2.45 
1.01 to 3.00 3.95 





3.01 and over 5.55 541 | 


Write an application named UsePackage that instantiates at least three objects of 
each type (Package and InsuredPackage) using a variety of weights and shipping 
method codes. Display the results for each Package and InsuredPackage. Save the 
files as Package.java, InsuredPackage.java, and UsePackage.java. 





7. Create a class named CarRental that contains fields that hold a renter’s name, 
zip code, size of the car rented, daily rental fee, length of rental in days, and 
total rental fee. The class contains a constructor that requires all the rental data 
except the daily rate and total fee, which are calculated based on the size of the car: 
economy at $29.99 per day, midsize at $38.99 per day, or full size at $43.50 per day. 
The class also includes a display() method that displays all the rental data. 
Create a subclass named LuxuryCarRental. This class sets the rental fee at $79.99 
per day and prompts the user to respond to the option of including a chauffeur 
at $200 more per day. Override the parent class display() method to include 
chauffeur fee information. Write an application named UseCarRental that 
prompts the user for the data needed for a rental and creates an object of the 
correct type. Display the total rental fee. Save the files as CarRental.java, 
LuxuryCarRental.java, and UseCarRental.java. 


8. Create a class named CollegeCourse that includes data fields that hold the 
department (for example, ENG), the course number (for example, 101), the credits 
(for example, 3), and the fee for the course (for example, $360). All of the fields 
are required as arguments to the constructor, except for the fee, which is calculated 
at $120 per credit hour. Include a display() method that displays the course 
data. Create a subclass named LabCourse that adds $50 to the course fee. Override 
the parent class display() method to indicate that the course is a lab course and 
to display all the data. Write an application named UseCourse that prompts the 
user for course information. If the user enters a class in any of the following 
departments, create a LabCourse: BIO, CHM, CIS, or PHY. If the user enters any 
other department, create a CollegeCourse that does not include the lab fee. 

Then display the course data. Save the files as CollegeCourse.java, LabCourse.java, 
and UseCourse.java. 













9. Create a class named Vehicle that acts as a superclass for vehicle types. The 
Vehicle class contains private variables for the number of wheels and the average 
number of miles per gallon. The Vehicle class also contains a constructor with 
integer arguments for the number of wheels and average miles per gallon, and a 
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toString() method that returns a String containing these values. Create two 
subclasses, Car and MotorCycle, that extend the Vehicle class. Each subclass 
contains a constructor that accepts the miles-per-gallon value as an argument 
and forces the number of wheels to the appropriate value—2 for a MotorCycle 
—— and 4 for a Car. Write a UseVehicle class to instantiate the two Vehicle objects and 
a 542 | display the objects’ values. Save the files as Vehicle.java, Car.java, MotorCycle.java, 
— and UseVehicle.java. 


10. Develop a set of classes for a college to use in various student service and personnel 
applications. Classes you need to design include the following: 


e Person—A Person contains a first name, last name, street address, zip code, and 
phone number. The class also includes a method that sets each data field, using a 
series of dialog boxes and a display method that displays all of a Person’s 
information on a single line at the command line on the screen. 


e CollegeEmployee—CollegeEmployee descends from Person. A CollegeEmployee 
also includes a Social Security number, an annual salary, and a department name, 
as well as methods that override the Person methods to accept and display all 
CollegeEmployee data. 


e Faculty—Faculty descends from CollegeEmployee. This class also includes 
a Boolean field that indicates whether the Faculty member is tenured, as well as 
methods that override the CollegeEmployee methods to accept and display this 
additional piece of information. 


e Student—Student descends from Person. In addition to the fields available in 
Person, a Student contains a major field of study and a grade point average as well 
as methods that override the Person methods to accept and display these 
additional facts. 


Write an application named CollegeList that declares an array of four “regular” 
CollegeEmployees, three Faculty, and seven Students. Prompt the user to specify 
which type of person’s data will be entered (C, F, or S), or allow the user to quit (Q). 
While the user chooses to continue (that is, does not quit), accept data entry for the 
appropriate type of Person. If the user attempts to enter data for more than four 
CollegeEmployees, three Faculty, or seven Students, display an error message. 
When the user quits, display a report on the screen listing each group of Persons 
under the appropriate heading of College Employees, Faculty, or Students. If the user 
has not entered data for one or more types of Persons during a session, display an 
appropriate message under the appropriate heading. 








Save the files as Person.java, CollegeEmployee.java, Faculty.java, Student.java, 
and CollegeList.java. 
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a Debugging Exercises 


1. Each of the following files in the Chapter10 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem andfixthe = 
program. After you correct the errors, save each file using the same filename | 543 a 
preceded with Fix. For example, DebugTen1.java will become FixDebugTenl.java. = |—— 


a. 


b 
C. 
d. 
e 


DebugTenl.java 
DebugTen2.java 
DebugTen3.java 
DebugTen4.java 


Eight other Debug files in the Chapter10 folder; these files are used by the 
DebugTen exercises 


oe Game Zone 
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. Create an Alien class. Include at least three protected data members of 


your choice, such as the number of eyes the Alien has. Include a constructor 
that requires a value for each data field and a toString() method that returns 
a String containing a complete description of the Alien. Save the file as 
Alien.java. 


Create two classes—Martian and Jupiterian—that descend from Alien. 
Supply each with a constructor that sets the Alien data fields with values 
you choose. For example, you can decide that a Martian has four eyes but a 
Jupiterian has only two. Save the files as Martian.java and Jupiterian.java. 


Create an application that instantiates one Martian and one Jupiterian. Call 
the toStringQ method with each object and display the results. Save the 
application as CreateAliens.java. 


. In Chapter 4, you created a Die class that you can use to instantiate objects that 


hold one of six randomly selected values. Modify this class so its value field is 
protected instead of private. This will allow a child class to access the value. 
Save the file as Die.java. 













Create a LoadedDie class that can be used to give a player a slight advantage 
over the computer. A LoadedDie never rolls a 1; it only rolls values 2 through 6. 
Save the file as LoadedDie.java. 


Create a program that rolls two Die objects against each other 1,000 times and 
counts the number of times the first Die has a higher value than the other Die. 
Then roll a Die object against a LoadedDie object 1,000 times, and count the 
number of times the Die wins. Display the results. Save the application as 
TestLoadedDie.java. Figure 10-30 shows two typical executions. 


APTER 10 Introduction to Inheritance 


iC=\Java>java TestLoadedDie 
With two regular dice. the first die won 426 times out of 1000 
With one die and one loaded die. the first die won 293 times out of 1606 








iC=:\Java>java TestLoadedDie 
With two regular dice, the first die won 431 times out of 1666 
| 544 With one die and one loaded die, the first die won 264 times out of 1666 


(ESET De 


Figure 10-30 Two typical executions of the TestLoadedDie application 








\—) Case Problems 





1. a. In Chapter 8, you created an Event class for Carly’s Catering. Now extend the 
class to create a DinnerEvent class. In the extended class, include four new 
integer fields that represent numeric choices for an entrée, two side dishes, 
and a dessert for each DinnerEvent object. Also include three final arrays 
that contain String menu options for entrées, side dishes, and desserts, and 
store at least three choices in each array. Create a DinnerEvent constructor 
that requires arguments for an event number and number of guests, and integer 
menu choices for one entrée, two side dishes, and one dessert. Pass the first two 
parameters to the Event constructor, and assign the last four parameters to 
the appropriate local fields. Also include a getMenu() method that builds 
and returns a String including the Strings for the four menu choices. Save 
the file as DinnerEvent.java. 


b. In Chapter 9, you created an EventDemo program for Carly’s Catering. The 
program uses an array of Event objects and allows the user to sort Events in 
ascending order by event number, number of guests, or event type. Now 
modify the program to use an array of four DinnerEvent objects. Prompt the 
user for all values for each object, and then allow the user to continuously 
sort the DinnerEvent descriptions by event number, number of guests, or 
event type. Save the file as DinnerEventDemo.java. 















2. a. In Chapter 8, you created a Rental class for Sammy’s Seashore Supplies. 
Now extend the class to create a LessonWithRental class. In the extended 
class, include a new Boolean field that indicates whether a lesson is required 
or optional for the type of equipment rented. Also include a final array that 
contains Strings representing the names of the instructors for each of the eight 
equipment types, and store names that you choose in the array. Create a 
LessonWithRental constructor that requires arguments for an event number, 
minutes for the rental, and an integer equipment type. Pass the first two 
parameters to the Rental constructor, and assign the last parameter to the 
equipment type. For the first two equipment types (jet ski and pontoon boat), 
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set the Boolean lesson required field to true; otherwise, set it to false. Also 
include a getInstructor() method that builds and returns a String 
including the String for the equipment type, a message that indicates 
whether a lesson is required, and the instructor’s name. Save the file as 
LessonWithRental.java. 

545 








b. In Chapter 9, you created a RentalDemo program for Sammy’s Seashore 
Supplies. The program uses an array of Rental objects and allows the user to 
sort Rentals in ascending order by contract number, equipment type, or price. 
Now modify the program to use an array of four LessonWithRental objects. 
Prompt the user for all values for each object, and then allow the user to 
continuously sort the LessonWithRental descriptions by contract number, 
equipment type, or price. Save the file as LessonWithRentalDemo.java. 





Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has| 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additi 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





Advanced Inheritance 
Concepts 


In this chapter, you will: 


Create and use abstract classes 


(ORO) 


UKYMoNZar-lanl (om antciiatere me e)iavel lave 


Create arrays of subclass objects 


(©) 


Use the Object class and its methods 


(©) 


Use inheritance to achieve good software design 


(©) 


Create and use interfaces 


(©) 


Create and use packages 


(©) 
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CHAPTER 11 Advanced Inheritance Concepts 


Creating and Using Abstract Classes 


Developing new classes is easier after you understand the concept of inheritance. When you 

use a Class as a basis from which to create extended child classes, the child classes are more 

specific than their parent. When you create a child class, it inherits all the general attributes 
548 you need; thus, you must create only the new, more specific attributes. For example, a 
SalariedEmployee and an HourlyEmployee are more specific than an Employee. They can 
inherit general Employee attributes, such as an employee number, but they add specific 
attributes, such as pay-calculating methods. 





Notice that a superclass contains the features that are shared by its subclasses. For example, 
the attributes of the Dog class are shared by every Poodle and Spaniel. The subclasses are 
more specific examples of the superclass type; they add more features to the shared, general 
features. Conversely, when you examine a subclass, you see that its parent is more general and 
less specific; for example, Animal is more general than Dog. 


derived class, subclass, and child are equivalent. Also recall that a child class contains all the members of its 
parent, whether those members are public, protected, or private. However, a child object cannot 
directly access a private member inherited from a parent. 


Q Recall from Chapter 10 that the terms base class, superclass, and parent are equivalent. Similarly, the terms 


A concrete class is one from which you can instantiate objects. Sometimes, a class is so 
general that you never intend to create any specific instances of the class. For example, you 
might never create an object that is “just” an Employee; each Employee is more specifically a 
SalariedEmployee, HourlyEmployee, or ContractEmployee. A class such as Employee that 
you create only to extend from is not a concrete class; it is an abstract class. In the last 
chapter, you learned that you can create final classes if you do not want other classes to be 
able to extend them. Classes that you declare to be abstract are the opposite; your only 
purpose in creating them is to enable other classes to extend them. If you attempt to 
instantiate an object from an abstract class, you receive an error message from the compiler 
that you have committed an InstantiationError. You use the keyword abstract when you 
declare an abstract class. (In other programming languages, such as C++, abstract classes are 
known as virtual classes. ) 


In the last chapter, you learned to create class diagrams. By convention, when you show abstract classes 
and methods in class diagrams, their names appear in italics. 


class that extends the abstract class Calendar. In other words, there are no “plain” Calendar objects. 


Q In Chapter 4, you worked with the GregorianCalendar class. GregorianCalendar is a concrete 
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Creating and Using Abstract Classes) 


Programmers of an abstract class can include two method types: 


e Nonabstract methods, like those you can create in any class, are implemented in the 
abstract class and are simply inherited by its children. 


e Abstract methods have no body and must be implemented in child classes. 
549 








Abstract classes usually contain at least one abstract method. When you create an abstract 
method, you provide the keyword abstract and the rest of the method header, including the 
method type, name, and parameters. However, the declaration ends there: you do not provide 
curly braces or any statements within the method—just a semicolon at the end of the 
declaration. If you create an empty method within an abstract class, the method is an abstract 
method even if you do not explicitly use the keyword abstract when defining the method, 
but programmers often include the keyword for clarity. If you declare a class to be abstract, its 
methods can be abstract or not, but if you declare a method to be abstract, you must also 
declare its class to be abstract. 


When you create a subclass that inherits an abstract method, you write a method with the 
same signature. You are required to code a subclass method to override every empty, abstract 
superclass method that is inherited. Either the child class method must itself be abstract, or 
you must provide a body, or implementation, for the inherited method. 


Suppose that you want to create classes to represent different animals, such as Dog and 
Cow. You can create a generic abstract class named Animal so you can provide generic 
data fields, such as the animal’s name, only once. An Animal is generic, but all specific 
Animals make a sound; the actual sound differs from Animal to Animal. If you code an 
empty speak() method in the abstract Animal class, you require all future Animal 
subclasses to code a speak() method that is specific to the subclass. Figure 11-1 shows 
an abstract Animal class containing a data field for the name, getName() and setName() 
methods, and an abstract speak() method. 


public abstract class Animal 
{ 
private String name; 
public abstract void speak(); 
public String getName() 
{ 


return name; 


} 
public void setName(String animalName) 


{ 


name = animalName; 


} 





Figure 11-1 The abstract Animal class 
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The Animal class in Figure 11-1 is declared as abstract; the keyword is shaded. You 
cannot create a class in which you declare an Animal object with a statement such as 
Animal myPet = new Animal("Murphy");, because a class that attempts to instantiate an 
Animal object does not compile. Anima] is an abstract class, so no Animal objects can exist. 


You create an abstract class such as Animal only so you can extend it. For example, because 
a dog is an animal, you can create a Dog class as a child class of Animal. Figure 11-2 shows a 
Dog class that extends Animal. 


550 





public class Dog extends Animal 


{ 
public void speak() 
{ 


i: 


System.out.printInC"Woof!"); 





Figure 11-2 The Dog class 


The speak() method within the Dog class is required because you want to create Dog 
objects and the abstract, parent Animal class contains an abstract speak() method (shaded 
in Figure 11-1). You can code any statements you want within the Dog speak() method, 
but the speak() method must exist. If you do not want to create Dog objects but want the 
Dog class to be a parent to further subclasses, then the Dog class must also be abstract. 

In that case, you can write code for the speak() method within the subclasses of Dog. 


If Animal is an abstract class, you cannot instantiate an Animal object; however, if Dog is a 
concrete class, instantiating a Dog object is perfectly legal. When you code the following, 
you create a Dog object: 

Dog myPet = new Dog("Murphy") ; 

Then, when you code myPet.speak() ;, the correct Dog speak() method executes. 


The classes in Figures 11-3 and 11-4 also inherit from the Animal class and implement speak () 
methods. Figure 11-5 contains a UseAnimals application. 


public class Cow extends Animal 


{ 
public void speak() 
{ 


} 


System.out.printIn(C"Moo!"); 





Figure 11-3 The Cow class 
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public class Snake extends Animal 


{ 


public void speak() 


{ 


System.out.printInC"Ssss!"); 
} 551 








Figure 11-4 The Snake class 


public class UseAnimals 
{ 
public static void main(String[] args) 
{ 
Dog myDog = new Dog(); 
Cow myCow = new Cow(); 
Snake mySnake = new Snake(Q); 
myDog.setName("My dog Murphy"); 
myCow.setName("My cow Elsie"); 


mySnake.setName("My snake Sammy") ; 
System.out.print(myDog.getName() + 
myDog. speak () ; 
System.out.print(myCow.getName() + 
myCow. speak () ; 
System.out.print(mySnake.getName() + 
mySnake. speak() ; 


says "); 


says "); 


says "); 





Figure 11-5 The UseAnimals application 


The output in Figure 11-6 shows that when you create Dog, Cow, and Snake objects, each is an 


Animal with access to the Animal class getName() and setName() methods, and each uses its 
own speak() method appropriately. 


In Figure 11-6, notice how the myDog. 


getName() and myDog.speak() method = Command Prompt n 
calls produce different output from when 








the same method names are used with C:\Java>java UseAnimals 
myCow and mySnake. ave Noort 
> i H 


Recall that using the same method name y snake § Sssst 
to indicate different implementations is 
polymorphism. Using polymorphism, one 
method name causes different and 
appropriate actions for diverse types of 
objects. Figure 11-6 Output of the UseAnimals application 
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ee . 
—T) Watch the video Abstract Classes. 


dale Creating and Using Abstract Classes 





1. An abstract class is one from which you cannot inherit, but from which you can 
create concrete objects. 


Abstract classes usually have one or more empty abstract methods. 
An abstract method has no body, curly braces, or statements. 


"Wuayul UeD NOA YIIYM WO. yng ‘sjIalgo 9}e19U09 
Aue 9}e919 Jouued NOA YoIUM WOd} BUO SI SSe}O JOeWISge UY “[# SI JUBWAa}e}s asje} ay] 


an You Do It 


Creating an Abstract Class 


In this section, you create an abstract Vehicle class. The class includes fields for 
the power source, the number of wheels, and the price. Vehicle is an abstract class; 
there will never be a “plain” Vehicle object. Later, you will create two subclasses, 
Sailboat and Bicycle; these more specific classes include price limits for the 
vehicle type, as well as different methods for displaying data. 


1. Open a new file in your text editor, and enter the following first few lines to 
begin creating an abstract Vehicle class: 


public abstract class Vehicle 


{ 


2. Declare the data fields that hold the power source, number of wheels, and 
price. Declare price aS protected rather than private, because you want 
child classes to be able to access the field. 


private String powerSource; 
private int wheels; 
protected int price; 


3. The Vehicle constructor accepts three parameters and calls three methods. 
The first method accepts the powerSource parameter, the second 


(continues) 
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(continued) 


accepts the wheels parameter, and the third method prompts 
the user for a vehicle price. 


public Vehicle(String powerSource, int wheels) 553 


{ 








setPowerSource(powerSource) ; 
setWheels (wheels); 
setPriceQ); 


} 
4. Include the following three get methods that return the values for the data fields: 


public String getPowerSource() 
{ 


} 
public int getWheels() 
{ 


} 
public int getPrice() 
{ 


} 


5. Enter the following set methods, which assign values to the powerSource and 
wheels fields. 


return powerSou rece; 


return wheels; 


return price; 


public void setPowerSource(String source) 


{ 


} 
public void setWheelsCint wis) 


{ 


} 


6. The setPriced method is an abstract method. Each subclass you eventually 
create that represents different vehicle types will have a unique prompt for the 
price and a different maximum allowed price. Type the abstract method 
definition and the closing curly brace for the class: 


powerSource = source; 


wheels = wis; 


public abstract void setPriceQ; 


} 


7. Save the file as Vehicle.java. At the command prompt, compile the file using 
the javac command. 


(continues) 
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(continued) 
Extending an Abstract Class 


You just created an abstract class, but you cannot instantiate any objects from this 
554 class. Rather, you must extend this class to be able to create any Vehiclerelated 
objects. Next, you create a Sailboat Class that extends the Vehicle class. This new 
class is concrete; that is, you can create actual Sailboat class objects. 





1. Open anew file in your text editor, and then type the following, including a header 
for a Sailboat class that extends the Vehicle class: 


import javax.swing.*; 
public class Sailboat extends Vehicle 


{ 


2. Add the declaration of a length field that is specific to a Sailboat by typing the 
following code: 


private int length; 


3. The Sailboat constructor must call its parent's constructor and send two 
arguments to provide values for the powerSource and wheels values. It also 
calls the setLength() method that prompts the user for and sets the length 
of the Sailboat objects: 


public Sailboat() 

{ 
superC"wind", 0); 
setLengthQ); 

} 


4. Enter the following setLengthQ and getLength() methods, which respectively 
ask for and return the Sailboat’s length: 


public void setLength() 
{ 
String entry; 
entry = JOptionPane.showInputDialog 
(null, "Enter sailboat length in feet "); 
length = Integer.parseInt(entry) ; 


} 
public int getLengthQ) 
{ 


} 


5. The concrete Sailboat class must contain a setPrice© method because 
the method is abstract in the parent class. Assume that a Sailboat has a 
maximum price of $100,000. Add the following setPrice() method that 


return length; 


(continues) 
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(continued) 
prompts the user for the price and forces it to the maximum value if the entered 
value is too high: 


ee void setPrice() 555 








String entry; 
final int MAX = 100000; 
entry = JOptionPane.showInputDialog 
(null, "Enter sailboat price "); 
price = Integer.parseInt(entry) ; 
if(price > MAX) 
price = MAX; 
} 


6. In Chapter 7, you first used the automatically included object class toStringO 
method that converts any object to a String. Now, you can override that method 
for this class by writing your own version as follows. When you finish, add a 
closing curly brace for the class. 


public String toStringQO 


{ 
return("The " + getLengthQ) + 
" foot sailboat is powered by " + 
getPowerSource() + "; it has " + getWheelsQ) + 
" wheels and costs $" + getPriceQ); 
} 


} 
7. Save the file as Sailboat.java, and then compile the class. 


Extending an Abstract Class with a Second Subclass 


The Bicycle Class inherits from Vehicle, just as the Sailboat class does. Whereas the Sai Tboat 
class requires a data field to hold the length of the boat, the Bicycle class does not. Other 
differences lie in the content of the setPriceQ and toString® methods. 


1. Open a new file in your text editor, and then type the following first lines of 
the Bicycle class: 


import javax.swing.*; 
public class Bicycle extends Vehicle 


{ 


2. Enter the following Bicycle class constructor, which calls the parent 
constructor, sending it power source and wheel values: 


public Bicycle() 
{ 


} 


super("a person", 2); 


(continues) 
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(continued) 


3. Enter the following setPrice() method that forces a Bicycle’s price to be no 
greater than $4,000: 


public void setPrice() 


556 { 





String entry; 
final int MAX = 4000; 
entry = JOptionPane.showInputDialog 
(null, "Enter bicycle price "); 
price = Integer.parseInt(entry) ; 
if(price > MAX) 
price = MAX; 
} 


4. Enter the following toStringQ method, and add the closing curly brace for the class: 


public String toStringQ 


{ 
return("The bicycle is powered by " + getPowerSource() + 
"; it has " + getWheels() + " wheels and costs $" + 
getPrice()); 
} 


} 
5. Save the file as Bicycle.java, and then compile the class. 


Instantiating Objects from Subclasses 


Next, you create a program that instantiates concrete objects from each of the two 
child classes you just created. 


1. Open a new file in your text editor, and then enter the start of the DemoVehicles 
class as follows: 


import javax.swing.*; 
public class DemoVehicles 


{ 
public static void main(String[] args) 


{ 
2. Enter the following statements that declare an object of each subclass type. 


Sailboat aBoat = new Sailboat(); 
Bicycle aBike = new BicycleQ); 


3. Enter the following statement to display the contents of the two objects. Add 
the closing curly braces for the main® method and the class: 


JOptionPane. showMessageDialog(nul1, 
"\nVehicle descriptions:\n" + 
aBoat.toStringQ) + "\n" + aBike.toStringQ); 


H (continues) 
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(continued) 


4. Save the file as DemoVehicles.java, and then compile it. After you compile the 
class with no errors, run this application using the java DemoVehicles command. 
When the application prompts you, enter the length and price for a sailboat, and 


the price for a bicycle. Figure 11-7 shows output after typical user input. oF 








@ Vehicle descriptions: 
The 26 foot sailboat is powered by wind; it has 0 wheels and costs $45000 


The bicycle is powered by a person; it has 2 wheels and costs $1985 





Figure 11-7 Typical output of the DemoVehicles application 


Using Dynamic Method Binding 


When you create a superclass and one or more subclasses, each object of each subclass 

“is a” superclass object. Every SalariedEmployee “is an” Employee; every Dog “is an” Animal. 
(The opposite is not true. Superclass objects are not members of any of their subclasses. 
An Employee is not a SalariedEmployee. An Animal is not a Dog.) Because every subclass 
object “is a” superclass member, you can convert subclass objects to superclass objects. 


As you are aware, when a superclass is abstract, you cannot instantiate objects of the 
superclass; however, you can indirectly create a reference to a superclass abstract object. 

A reference is not an object, but it points to a memory address. When you create a reference, 
you do not use the keyword new to create a concrete object; instead, you create a variable 
name in which you can hold the memory address of a concrete object. So, although a 
reference to an abstract superclass object is not concrete, you can store a concrete 

subclass object reference there. 


are creating a reference. If you later code the following statement, including the keyword new and the 


You learned how to create a reference in Chapter 4. When you code SomeClass someObject;, you 
Y constructor name, then you actually set aside memory for someObject: 


someObject = new SomeClass(); 
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For example, if you create an Animal class, as shown previously in Figure 11-1, and various 
subclasses, such as Dog, Cow, and Snake, as shown in Figures 11-2 through 11-4, you can 
create an application containing a generic Animal reference variable into which you can 
assign any of the concrete Animal child objects. Figure 11-8 shows an AnimalReference 
application, and Figure 11-9 shows its output. The variable animalRef is a type of Animal. 
558 No superclass Animal object is created (none can be); instead, Dog and Cow objects are 
created using the new keyword. When the Cow object is assigned to the Animal reference, 
the animalRef.speak() method call results in “Moo!”; when the Dog object is assigned to 
the Animal reference, the method call results in “Woof!” Recall that assigning a variable 
or constant of one type to a variable of another type is called promotion, implicit conversion, 
or upcasting. 








public class AnimalReference 


1 


public static void main(String[] args) 


1 


Animal animalRef; 
animalRef = new CowQ); 
animalRef.speakQ) ; 
animalRef = new Dog(); 
animalRef.speakQ) ; 











Figure 11-9 Output of the AnimalReference application 


The application in Figure 11-8 shows that using a reference polymorphically allows you to 
extend a base class and use extended objects when a base class type is expected. For example, 
you could pass a Dog or a Cow to a method that expects an Animal. This means that all 
methods written to accept a superclass argument can also be used with its children—a feature 
that saves child-class creators a lot of work. 
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Recall from Chapter 10 that you can use the instanceof keyword to determine whether an object is an 
instance of any class in its hierarchy. For example, both of the following expressions are true if myPood1e is 
a Dog object and Dog is an Anima] subclass: 


myPoodle instanceof Animal 
myPoodle instanceof Dog 


The application in Figure 11-8 demonstrates polymorphic behavior. The same statement, 559 


animalRef.speak() ;, repeats after animalRef is assigned each new animal type. Each call to 
the speakQ method results in different output. Each reference “chooses” the correct speak () 
method, based on the type of animal referenced. This flexible behavior is most useful when 
you pass references to methods; you will learn more about this in the next section. In the 
last chapter, you learned that in Java all instance method calls are virtual method calls by 
default—the method that is used is determined when the program runs, because the type 
of the object used might not be known until the method executes. An application’s ability to 
select the correct subclass method depending on the argument type is known as dynamic 
method binding. When the application executes, the correct method is attached (or bound) to 
the application based on the current, changing (dynamic) context. Dynamic method binding 
is also called late method binding. The opposite of dynamic method binding is static (fixed) 
method binding. In Java, instance methods (those that receive a this reference) use dynamic 
binding; class methods use static method binding. Dynamic binding makes programs flexible; 
however, static binding operates more quickly. 








Animals). Be aware that polymorphic behavior can apply to nonrelated classes as well. For example, a 
DebateStudent and a Ventri loquistsDummy might also speak C). When polymorphic behavior 
depends on method overloading, it is called ad-hoc polymorphism; when it depends on using a superclass 
as a method parameter, it is called pure polymorphism or inclusion polymorphism. 


Q In the example in this section, the objects using speak () happen to be related (Cow and Dog are both 


Using a Superclass as a Method Parameter Type 


Dynamic method binding is most useful when you want to create a method that has one or 
more parameters that might be one of several types. For example, the shaded header for the 
talkingAnimal() method in Figure 11-10 accepts any type of Animal argument. The method 
can be used in programs that contain Dog objects, Cow objects, or objects of any other class 
that descends from Animal. The application passes first a Dog and then a Cow to the method. 
The output in Figure 11-11 shows that the method works correctly no matter which type of 
Animal descendant it receives. 
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public class TalkingAnimalDemo 
| { 
public static void main(String[] args) 
{ 
560 Dog dog = new Dog(); 
Cow cow new Cow(); 
dog.setName("Ginger") ; 
cow.setName("Molly"); 
talkingAnimal (dog) ; 
talkingAnimal (cow) ; 


Il 





Il 


} 
public static void talkingAnimal (Animal animal) 
{ 
System.out.printInC"Come one. Come all."); 
System.out.printIn 
C"See the amazing talking animal!"); 
System.out.printInCanimal.getNameQ) + 
" says"); 
animal.speakQ); 
System. out.printIn("*** 





Figure 11-10 The TalkingAnimalDemo class 





a 





Command Prompt 


C:\Java>java TalkingfnimalDemo 
Come one. Come all. 


FORE 


Come all. 
amazing talking animal? 


FSH HeeHHHeHet 


C:\Java>_ 





Figure 11-11 Output of the TalkingAnimalDemo application 
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Creating Arrays of Subclass Objects D0 


Using Dynamic Method Binding 


1. If Parent is a parent class and Child is its child, then you can assign a Child 561 
object to a Parent reference. 








2. If Parent is a parent class and Child is its child, then you can assign a Parent 
object to a Child reference. 


3. Dynamic method binding refers to a program’s ability to select the correct 
subclass method for a superclass reference while a program is running. 
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Creating Arrays of Subclass Objects 


Recall that every array element must be the same data type, which can be a primitive, built-in 
type or a type based on a more complex class. When you create an array in Java, you are not 
constructing objects. Instead, you are creating space for references to objects. In other words, 
although it is convenient to refer to “an array of objects,” every array of objects is really an 
array of object references. When you create an array of superclass references, it can hold 
subclass references. This is true whether the superclass in question is abstract or concrete. 


For example, even though Employee is an abstract class, and every Employee object is either a 
SalariedEmployee or an HourlyEmployee subclass object, it can be convenient to create an 
array of generic Employee references. Likewise, an Animal array might contain individual 
elements that are Dog, Cow, or Snake objects. As long as every Employee subclass has access to 
a calculatePay() method, and every Animal subclass has access to a speak() method, you 
can manipulate an array of superclass objects and invoke the appropriate method for each 
subclass member. 


The following statement creates an array of three Animal references: 
Animal[] animalRef = new Animal [3]; 


The statement reserves enough computer memory for three Animal objects named 
animalRef[0], animalRef[1], and animalRef[2]. The statement does not actually instantiate 
Animals; Animal is an abstract class and cannot be instantiated. The Animal array declaration 
simply reserves memory for three object references. If you instantiate objects from Animal 
subclasses, you can place references to those objects in the Animal array, as Figure 11-12 
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illustrates. Figure 11-13 shows the output of the AnimalArrayDemo application. The array of 
three references is used to access each appropriate speak() method. 


public class AnimalArrayDemo 


562 i 





public static void main(String[] args) 


{ 


Animal[] animalRef = new Animal[3]; 
animalRef[0] = new Dog(Q); 
animalRef[1] = new CowQ); 


animalRef[2] = new SnakeQ; 
for(int x = 0; x < 3; ++x) 
animalRef [x] .speak() ; 








\Java> 








Figure 11-13 Output of the AnimalArrayDemo application 


In the AnimalArrayDemo application in Figure 11-12, a reference to an instance of the Dog 
class is assigned to the first Animal reference, and then references to Cow and Snake objects 
are assigned to the second and third array elements. After the object references are in the 
array, you can manipulate them like any other array elements. The application in Figure 11-12 
uses a for loop and a subscript to get each individual reference to speak(). 
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Creating Arrays of Subclass Objects 





1. You can assign a superclass reference to an array of its subclass type. 563 





2. The following statement creates an array of 10 Table references: 
Table[] table = new Table[10]; 
3. You can assign subclass objects to an array that is their superclass type. 
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“ns You Do It 


Using Object References 


Next, you write an application in which you create an array of Vehicle references. 
Within the application, you assign Sailboat objects and Bicycle objects to the same 
array. Then, because the different object types are stored in the same array, you can 
easily manipulate them by using a for loop. 


1. Open a new file in your text editor, and then enter the following first few lines 
of the VehicleDatabase program: 
import javax.swing.*; 
public class VehicleDatabase 


{ 
public static void main(String[] args) 


{ 
2. Create the following array of five Vehicle references and an integer subscript 
to use with the array: 
Vehicle[] vehicles = new Vehicle[5]; 
int x; 
3. Enter the following for loop that prompts you to select whether to enter 
a Sailboat or a bicycle in the array. Based on user input, instantiate the 
appropriate object type. 


(continues) 
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(continued) 

for(x = 0; x < vehicles.length; ++x) 
{ 

String userEntry; 

int vehicleType; 

userEntry = JOptionPane. showInputDialog(nul1, 
564 "Please select the type of\n " + 

"vehicle you want to enter: \nl - Sailboat\n" + 

"2 - Bicycle"); 
vehicleType = Integer.parseInt(userEntry) ; 
if(vehicleType == 1) 

vehicles[x] = new Sailboat(); 
else 

vehicles[x] = new BicycleQ; 





} 


4. After entering the information for each vehicle, display the array contents by 
typing the following code. First create a StringBuffer to hold the list of vehicles. 
Then, in a for loop, build an output String by repeatedly adding a newline 
character, a counter, and a vehicle from the array to the StringBuffer object. 
Display the constructed StringBuffer in a dialog box. Then type the closing 
curly braces for the main method and the class: 

StringBuffer outString = new StringBufferQ; 
for(x = 0; x < vehicles.length; ++x) 


{ 
outString.append("\n#" + (x + 1) +" "); 
outString.append(vehicles[x].toStringQ); 
} 
JOptionPane.showMessageDialog(nul1, 
"Our available Vehicles include:\n" + 
outString) ; 


} 


5. Save the file as VehicleDatabase.java, and then compile it. Run the application, 
entering five objects of your choice. Figure 11-14 shows typical output after the 
user has entered data. 


Our available Vehicles include: 


#1 The bicycle is powered by a person; it has 2 wheels and costs $2400 
#2 The 22 foot sailboat is powered by wind; it has 0 wheels and costs $35000 


#3 The 26 foot sailboat is powered by wind; it has 0 wheels and costs $48500 
#4 The bicycle is powered by a person; it has 2 wheels and costs $1500 
#5 The bicycle is powered by a person; it has 2 wheels and costs $750 





Figure 11-14 Output of the VehicleDatabase application 
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Using the Object Class and Its Methods 


Every class in Java is actually a subclass, except one. When you define a class, if you do not 
explicitly extend another class, your class implicitly is an extension of the Object class. The 
Object class is defined in the java. lang package, which is imported automatically every time 
you write a program; in other words, the following two class declarations have identical 565 
outcomes: 








public class Animal 
{ 
} 


public class Animal extends Object 
{ 
} 


When you declare a class that does not extend any other class, you always are extending the 
Object class. The Object class includes methods that descendant classes can use or override 
as you see fit. Table 11-1 describes the methods built into the Object class; every Object you 
create has access to these methods. 





Method Description 

Object cloneQ Creates and returns a copy of this object 

boolean equals Indicates whether some object is equal to the parameter object (this method 
(Object obj) is described in detail below) 

void finalizeQ Called by the garbage collector on an object when there are no more 


references to the object 
Class<?> getClass() Returns the class to which this object belongs at run time 


int hashCode() Returns a hash code value for the object (this method is described 
briefly below) 


void notifyQ Wakes up a single thread that is waiting on this object’s monitor 
void notifyAl1Q Wakes up all threads that are waiting on this object's monitor 


String toString() _ Returns a string representation of the object (this method is described 
in detail below) 


void wait Causes the current thread to wait until either another thread invokes 

Clong timeout) the notify( method or the noti fyA11Q method for this object, or 
a specified amount of time has elapsed 

void wait Causes the current thread to wait until another thread invokes the 

Clong timeout, notifyQ or notifyA11Q method for this object, or some other 

int nanos) thread interrupts the current thread, or a certain amount of real time 
has elapsed 


Leon) Object class methods 
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StringBuffer class. Threads of execution are units of processing that are scheduled by an operating 


Table 11-1 refers to threads in several locations. In Chapter 7, you learned about threads in reference to the 
GY system and that can be used to create multiple paths of control during program execution. 


566 





Using the toStringQ Method 


The Object class toStringQ method converts an Object into a String that contains 
information about the Object. Within a class, if you do not create a toStringQ) method 
that overrides the version in the Object class, you can use the superclass version of the 
toString() method. For example, examine the Dog class originally shown in Figure 11-2 
and repeated in Figure 11-15. Notice that it does not contain a toString() method and 
that it extends the Animal class. 


public abstract class Animal 
{ 
private String name; 
public abstract void speak(); 
public String getName() 
{ 


} 
public void setName(String animalName) 


{ 
} 


return name; 


name = animalName; 


} 


public class Dog extends Animal 


{ 
public void speak() 
{ 


- 


System. out.printInC"Woof!"); 
} 


public class DisplayDog 
{ 


public static void main(String[] args) 


af 


Dog myDog = new DogQ); 
String dogString = myDog.toString() ; 
System.out.printInCdogString) ; 





Figure 11-15 The Animal and Dog classes and the DisplayDog application 
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Notice that neither the Animal class nor the Dog class in Figure 11-15 defines a toString 
method. Yet, when you write the DisplayDog application in Figure 11-15, it uses a 
toString() method with a Dog object in the shaded statement. The class compiles 
correctly, converts the Dog object to a String, and produces the output shown in 


Figure 11-16 because Dog inherits toString() from Object. 
567 











re 





fy Command Prompt =" a 


mt 


C:\Java>java DisplayDog 
Dog@addbfi 


C:\Java> 





Figure 11-16 Output of the DisplayDog application 


The output of the DisplayDog application in Figure 11-16 is not very useful. It consists of 
the class name of which the object is an instance (Dog), the at sign ( @ ), and a hexadecimal 
(base 16) number that represents a unique identifier for every object in the current application. 
The hexadecimal number that is part of the String returned by the toString() method 
(addbf1 in Figure 11-16) is an example of a hash code—a calculated number used to 
identify an object. Later in this chapter, you learn about the equals() method, which 
also uses a hash code. 


Instead of using the automatic toStringQ method with your classes, it is usually more useful 
to write your own overloaded version that displays some or all of the data field values for the 
object with which you use it. A good toString() method can be very useful in debugging a 
program; if you do not understand why a class is behaving as it is, you can display the 
toString() value and examine its contents. For example, Figure 11-17 shows a BankAccount 
class that contains a mistake in the shaded line—the BankAccount balance value is set to the 
account number instead of the balance amount. Of course, if you made such a mistake within 
one of your own classes, there would be no shading or comment to help you find the mistake. 
In addition, a useful BankAccount class would be much larger, so the mistake would be more 
difficult to locate. However, when you ran programs containing BankAccount objects, you 
would notice that the balances of your BankAccounts were incorrect. To help you discover 
why, you could create a short application like the TestBankAccount class in Figure 11-18. 
This application uses the BankAccount class toString() method to display the relevant 
details of a BankAccount object. The output of the TestBankAccount application appears in 
Figure 11-19. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce: earning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 11 Advanced Inheritance Concepts 


public class BankAccount 
{ 
private int acctNum; 
private double balance; 
568 public BankAccount(int num, double bal) 
{ 





Don't Do It 
The bal parameter should be 


acctNum 
balance = 


} assigned to balance, not the 
num parameter. 


public String toString() 
t 
String info = "BankAccount acctNum = " + acctNum + 
" Balance = $" + balance; 


return info; 





Figure 11-17 The BankAccount class 











public class TestBankAccount 


{ 
public static void main(String[] args) 
{ 
BankAccount myAccount = new BankAccount(123, 4567.89); 
System.out.printIn(myAccount. toStringQ); 
} 
} 





Figure 11-18 The TestBankAccount application 


a) 


Cz\Java>java TestBankAccount 
Bankfccount acctNum 123 Balance $123.8 








Cz\Java> 














Figure 11-19 Output of the TestBankAccount application 


From the output in Figure 11-19, you can see that the account number and balance have 
the same value, and this knowledge might help you to pin down the location of the 
incorrect statement in the BankAccount class. Of course, you do not have to use a method 
named toString() to discover a BankAccount’s attributes. If the class had methods such 
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as getAcctNum() and getBalance(), you could use them to create a similar application. 
The advantage of creating a toStringQ method for your classes is that toString is Java’s 
conventional name for a method that converts an object’s relevant details into String format. 
Because toString() originates in the Object class, you can be assured that toString() 
compiles with any object whose details you want to see, even if the method has not been 
rewritten for the subclass in question. In addition, as you write your own applications and 569 
use classes written by others, you can hope that those programmers have overridden 

toString() to provide useful information. You don’t have to search documentation to 

discover a useful method—instead you can rely on the likely usefulness of toString(). 

In Chapter 7, you learned that you can use the toString() method to convert any object 

to a String. Now you understand why this works—the String class overloads the Object 

class toString() method. 








Using the equals) Method 


The Object class also contains an equals() method that takes a single argument, which 
must be the same type as the type of the invoking object, as in the following example: 


if (someObject .equals(someOtherObjectOfTheSameType) ) 
System.out.printIn("The objects are equal"); 


Object class method. You first used the equals() method to compare String objects in Chapter 7. 


Other classes, such as the String class, also have their own equals () methods that overload the 
Y Two String objects are considered equal only if their String contents are identical. 


The Object class equals() method returns a boolean value indicating whether the objects 
are equal. This equalsQ method considers two objects of the same class to be equal only if 
they have the same hash code; in other words, they are equal only if one is a reference to the 
other. For example, two BankAccount objects named myAccount and yourAccount are not 
automatically equal, even if they have the same account numbers and balances; they are equal 
only if they have the same memory address. If you want to consider two objects to be equal 
only when one is a reference to the other, you can use the built-in Object class equals() 
method. However, if you want to consider objects to be equal based on their contents, you 
must write your own equals() method for your classes. 


representing the hash code. (Discovering this number is of little use to you. The default hash code is 
the internal JVM memory address of the object.) However, whenever you override the equals () 
method in a professional class, you generally want to override the hashCode) method as well, 
because equal objects should have equal hash codes, particularly if the objects will be used in 
hash-based methods. See the documentation at the Java Web site for more details. 


Q Java’s Object class contains a public method named hashCode() that returns an integer 
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The application shown in Figure 11-20 instantiates two BankAccount objects using the 
BankAccount class in Figure 11-17. The BankAccount class does not include its own equals () 
method, so it does not override the Object equals() method. Thus, the application in 
Figure 11-20 produces the output in Figure 11-21. Even though the two BankAccount 
objects have the same account numbers and balances, the BankAccounts are not 

570 considered equal because they do not have the same memory address. 





public class CompareAccounts 


{ 


public static void main(String[] args) 


{ 


BankAccount acctl = new BankAccount(1234, 500.00); 
BankAccount acct2 = new BankAccount(1234, 500.00); 
if(acct1.equals(acct2)) 
System.out.printInC"Accounts are equal"); 
else 
System.out.printInC"Accounts are not equal"); 





va ComparefAccounts 
ounts are not equal 


Cz\Java> 








Figure 11-21 Output of the CompareAccounts application 


If your intention is that within applications, two BankAccount objects with the same account 
number and balance are equal, and you want to use the equals() method to make the 
comparison, you must write your own equals() method within the BankAccount class. For 
example, Figure 11-22 shows a new version of the BankAccount class containing a shaded 
equals() method. When you reexecute the CompareAccounts application in Figure 11-20, 
the result appears as in Figure 11-23. 
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public class BankAccount 

{ 
private int acctNum; 
private double balance; 
public BankAccount(int num, double bal) 571 
{ 








acctNum = num; 
balance = bal; 
} 
public String toString() 
{ 
String info = "BankAccount acctNum = " + acctNum + 
" Balance = $" + balance; 
return info; 
} 
public boolean equals(BankAccount secondAcct) 
{ 


boolean result; 


ifCacctNum == secondAcct.acctNum && balance == secondAcct.balance) 
result = true; 

else 
result = false; 

return result; 





a>java ComparefAccounts 
Accounts are equal 


C:\Java> 








Figure 11-23 Output of the CompareAccounts application after adding an overloaded equals () 
method to the BankAccount class 


The two BankAccount objects described in the output in Figure 11-23 are equal because 
their account numbers and balances match. Because the equals() method in Figure 11-22 
is part of the BankAccount class, and because equals() is a nonstatic method, the object 
that calls the method is held by the this reference within the method. That is, in the 
application in Figure 11-22, acct1 becomes the this reference in the equals() method, 
so the fields acctNum and balance refer to acct1 object values. In the CompareAccounts 
application, acct2 is the argument to the equals() method, so within the equals() 
method, acct2 becomes secondAcct, and secondAcct.acctNum and secondAcct.balance 
refer to acct2’s values. 
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Your organization might consider two BankAccount objects equal if their account numbers 
match, disregarding their balances. If so, you simply change the if clause in the equals () 
method. Or, you might decide accounts are equal based on some other criteria. You can 
implement the equals() method in any way that suits your needs. When you want to 
compare the contents of two objects, you do not have to overload the Object class equals Q 
572 method. Instead, you could write a method with a unique name, such as areTheyEqual() or 
areContentsSame(). However, as with the toString( method, users of your classes will 
appreciate that you use the expected, usual, and conventional identifiers for your methods. 





recompile the class, you must also recompile any client applications (such as CompareAccounts) so 
the newly updated class can be relinked to the application and so the clients include the new features of 
the altered class. If you execute the CompareAccounts application but do not recompile BankAccount, 
the application continues to use the previously compiled version of the class. 


Q If you change a class (such as changing BankAccount by adding a new method), not only must you 


ee 
—T Watch the video The Object Class. 


Using the Object Class and Its Methods 


1. When you define a class, if you do not explicitly extend another class, your class 
is an extension of the Object class. 


2. The Object class is defined in the java. lang package that is imported 
automatically every time you write a program. 


3. The Object class toString() and equals() methods are abstract. 
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Using Inheritance to Achieve Good Software Design 


When an automobile company designs a new car model, the company does not build 
every component of the new car from scratch. The company might design a new feature 
completely from scratch; for example, at some point someone designed the first air bag. 
However, many of a new car’s features are simply modifications of existing features. The 
manufacturer might create a larger gas tank or more comfortable seats, but even these 
new features still possess many properties of their predecessors in the older models. 

Most features of new car models are not even modified; instead, existing components, such 
as air filters and windshield wipers, are included on the new model without any changes. 
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Similarly, you can create powerful computer programs more easily if many of their 
components are used either “as is” or with slight modifications. Inheritance does not give you 
the ability to write programs that you could not write otherwise. If Java did not allow you to 
extend classes, you could create every part of a program from scratch. Inheritance simply 
makes your job easier. Professional programmers constantly create new class libraries for use 
with Java programs. Having these classes available makes programming large systems more 573 
manageable. 








You have already used many “as is” classes, such as System and String. In these cases, your 
programs were easier to write than if you had to write these classes yourself. Now that you 
have learned about inheritance, you have gained the ability to modify existing classes. When 
you create a useful, extendable superclass, you and other future programmers gain several 
advantages: 


e Subclass creators save development time because much of the code needed for the class 
has already been written. 


e Subclass creators save testing time because the superclass code has already been tested 
and probably used in a variety of situations. In other words, the superclass code is reliable. 


e Programmers who create or use new subclasses already understand how the superclass 
works, so the time it takes to learn the new class features is reduced. 


e When you create a new subclass in Java, neither the superclass source code nor the 
superclass bytecode is changed. The superclass maintains its integrity. 


When you consider classes, you must think about the commonalities among them; then you 
can create superclasses from which to inherit. You might be rewarded professionally when 
you see your own superclasses extended by others in the future. 


Using Inheritance to Achieve Good Software Design 
1. If objectoriented programs did not support inheritance, programs could still be 
written, but they would be harder to write. 


2. When you create a useful, extendable superclass, you save development and 
testing time. 


3. When you create a new subclass in Java, you must remember to revise and 
recompile the superclass code. 


‘pasueyd si apova1Xq ssejauadns au} JOU apod adunos ssejosadns 
dy) Jayyiou ‘ener ul SSejoqns mau e ajeasd NOK ua ‘E# SI JUaWAIeIS aye} ay] 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 11 Advanced Inheritance Concepts 


Creating and Using Interfaces 


Some object-oriented programming languages, such as C++, allow a subclass to inherit from 

more than one parent class. For example, you might create an InsuredItem class that 

contains data fields pertaining to each possession for which you have insurance. Data fields 
574 might include the name of the item, its value, the insurance policy type, and so on. You might 
also create an Automobi1e class that contains data fields such as vehicle identification 
number, make, model, and year. When you create an InsuredAutomobi le class for a car 
rental agency, you might want to include InsuredItem information and methods, as well as 
Automobile information and methods. It would be convenient to inherit from both the 
InsuredItem and Automobile classes. The capability to inherit from more than one class is 
called multiple inheritance. 





Many programmers consider multiple inheritance to be a difficult concept, and when 
inexperienced programmers use it they encounter many problems. Programmers have to deal 
with the possibility that variables and methods in the parent classes might have identical 
names, which creates conflict when the child class uses one of the names. Also, you have 
already learned that a child class constructor must call its parent class constructor. When 
there are two or more parents, this task becomes more complicated—to which class should 
super() refer when a child class has multiple parents? For all of these reasons, multiple 
inheritance is prohibited in Java. A class can inherit from a superclass that has inherited from 
another superclass—this represents single inheritance with multiple generations. However, 
Java does not allow a class to inherit directly from two or more parents. 


Java, however, does provide an alternative to multiple inheritance—an interface. An interface 
looks much like a class, except that all of its methods (if any) are implicitly public and 
abstract, and all of its data items (if any) are implicitly public, static, and final. 

An interface is a description of what a class does but not how it is done; it declares 

method headers but not the instructions within those methods. When you create a class 
that uses an interface, you include the keyword implements and the interface name in the 
class header. This notation requires class objects to include code for every method in the 
interface that has been implemented. Whereas using extends allows a subclass to use 
nonprivate, nonoverridden members of its parent’s class, implements requires the subclass 
to implement its own version of each method. 


provides a way for unrelated objects to interact with each other. An interface is analogous to a protocol, 
which is an agreed-on behavior. In some respects, an AUtomobi |e can behave like an InsuredItem, and 
so can a House, a TelevisionSet, and a JewelryPiece. 


Q In English, an interface is a device or a system that unrelated entities use to interact. Within Java, an interface 


As an example, recall the Animal and Dog classes from earlier in this chapter. Figure 11-24 
shows these classes, with Dog inheriting from Animal. 
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public abstract class Animal 


{ 


private String name; 

public abstract void speak(); 
public String getName() 575 
{ 


} 
public void setName(String animalName) 


{ 
} 








return name; 


name = animalName; 


} 


public class Dog extends Animal 


{ 
public void speak() 
{ 


} 


System.out.printInC"Woof!"); 





Figure 11-24 The Animal and Dog classes 


You can create a Worker interface, as shown in Figure 11-25. For simplicity, this example 
gives the Worker interface a single method named work(). When any class implements 
Worker, it must either include a work() method or the new class must be declared abstract, 
and then its descendants must implement the method. 


public interface Worker 


{ 
} 


public void work(); 





Figure 11-25 The Worker interface 


The WorkingDog class in Figure 11-26 extends Dog and implements Worker. A WorkingDog 
contains a data field that a “regular” Dog does not—an integer that holds hours of training 
received. The WorkingDog class also contains get and set methods for this field. Because the 
WorkingDog class implements the Worker interface, it also must contain a work() method that 
calls the Dog speak() method, and then produces two more lines of output—a statement 
about working and the number of training hours. 
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public class WorkingDog extends Dog implements Worker 


{ 
private int hoursOfTraining; 
public void setHoursOfTraining(int hrs) 


576 { 


} 
public int getHoursOfTrainingQO 


{ 


} 
public void work() 


{ 





hoursOfTraining = hrs; 


return hoursOfTraining; 


speak() ; 

System.out.printInC"I am a dog who works"); 

System.out.printIn("I have " + hoursOfTraining + 
"hours of professional training!"); 





Figure 11-26 The WorkingDog class 


interfaces. A class can also implement an interface even though it does not extend any other class. When a 
class both extends and implements, like the WorkingDog class, by convention the implements clause 
follows the extends clause in the class header. 


Q As you know from other classes you have seen, a class can extend another class without implementing any 


The DemoWorkingDogs application in Figure 11-27 instantiates two WorkingDog objects. 
Each object can use the following methods: 


e The setNameQ and getName() methods that WorkingDog inherits from the Animal class 
e The speak() method that WorkingDog inherits from the Dog class 


e The setHoursOfTraining® and getHoursOfTraining() methods contained within the 
WorkingDog class 


e Thework() method that the WorkingDog class was required to contain when it used the 
phrase implements Worker; the work() method also calls the speak() method contained 
in the Dog class. 
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public class DemoWorkingDogs 
{ 
public static void main(String[] args) 


{ 


WorkingDog aSheepHerder = new WorkingDog(); 577 
WorkingDog aSeeingEyeDog = new WorkingDog() ; 
aSheepHerder.setName("Simon, the Border Collie"); 
aSeeingEyeDog.setName("Sophie, the German Shepherd") ; 
aSheepHerder. setHoursOfTraining(40) ; 
aSeeingEyeDog.setHoursOfTraining(300) ; 








System.out.printIn(aSheepHerder.getName() + 
aSheepHerder. speak () ; 
aSheepHerder.workQ() ; 
System.out.printIn(); // outputs a blank line for readability 


says "); 


System.out.printInCaSeeingEyeDog.getName() + 
aSeeingEyeDog.speak() ; 
aSeeingEyeDog.work() ; 


says "); 





Figure 11-27 The DemoWorkingDogs application 


Figure 11-28 shows the output when the DemoWorkingDogs application executes. Each 
animal is introduced, then it “speaks,” and then each animal “works,” which includes 
speaking a second time. Each Animal can execute the speak() method implemented in 
its own class, and each can execute the work() method contained in the implemented 
interface. Of course, the WorkingDog class was not required to implement the Worker 
interface; instead, it could have just contained a work() method that all WorkingDog 
objects could use. If WorkingDog was the only class that would ever use work(), such an 
approach would probably be the best course of action. However, if many classes will be 
Workers—that is, require a work() method—they all can implement work(). If you are 
already familiar with the Worker interface and its method, when you glance at a class 
definition for a WorkingHorse, WorkingBird, or Employee and see that it implements 
Worker, you do not have to guess at the name of the method that shows the work the 
class objects perform. Notice that when a class implements an interface, it represents a 
situation similar to inheritance. Just as a WorkingDog “is a” Dog and “is an” Animal, so too 
it “is a” Worker. 
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578 








| 
wort ron 


C:\Java>java DemoWorkingDogs 
Simon, the Border Collie says 





ae am a dog who works 
I have 46 hours of professional training? 


Sophie. the German Shepherd says 


I am a dog who works ; 
I have 306 hours of professional training? 


C:\Java> 











Figure 11-28 Output of the DemoWorkingDogs application 


You can compare abstract classes and interfaces as follows: 


e Abstract classes and interfaces are similar in that you cannot instantiate concrete objects 
from either one. 


e Abstract classes differ from interfaces because abstract classes can contain nonabstract 
methods, but all methods within an interface must be abstract. 


e Acclass can inherit from only one abstract superclass, but it can implement any number of 
interfaces. 


Beginning programmers sometimes find it difficult to decide when to create an abstract 
superclass and when to create an interface. Remember, you create an abstract class when you 
want to provide data or methods that subclasses can inherit, but at the same time these 
subclasses maintain the ability to override the inherited methods. 


Suppose that you create a CardGame class to use as a base class for different card games. 
It contains four methods named shuffle(), dealQ), displayRules(), and keepScore(). 
The shuffle() method works the same way for every CardGame, so you write the 
statements for shuffleQ within the superclass, and any CardGame objects you create 
later inherit shuffleQ). The methods dealQ, displayRules(), and keepScore() operate 
differently for every subclass (for example, for TwoPlayerCardGames, FourPlayerCardGames, 
BettingCardGames, and so on), so you force CardGame children to contain instructions 
for those methods by leaving them empty in the superclass. The CardGame class, 
therefore, should be an abstract superclass. When you write classes that extend the 
CardGame parent class, you inherit the shuffle() method, and write code within the 
deal(), displayRules(), and keepScore() methods for each specific child. 


You create an interface when you know what actions you want to include, but you also want 
every user to separately define the behavior that must occur when the method executes. 
Suppose that you create a MusicalInstrument class to use as a base for different musical 
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instrument object classes such as Piano, Violin, and Drum. The parent MusicalInstrument 
class contains methods such as playNote() and outputSound() that apply to every 
instrument, but you want to implement these methods differently for each type of 
instrument. By making MusicalInstrument an interface, you require every nonabstract 


subclass to code all the methods. 
579 








An interface specifies only the messages to which an object can respond; an abstract class can include 
GY methods that contain the actual behavior the object performs when those messages are received. 


You also create an interface when you want a class to implement behavior from more than 
one parent. For example, suppose that you want to create an interactive NameThatInstrument 
card game in which you play an instrument sound from the computer speaker, and ask 
players to identify the instrument they hear by clicking one of several cards that display 
instrument images. This game class could not extend from two classes, but it could extend 
from CardGame and implement MusicalInstrument. 


interface’s methods, the compiler error generated indicates that you must declare your class to be 

abstract. If you want your class to be used only for extending, you can make it abstract. However, if your 
intention is to create a class from which you can instantiate objects, do not make it abstract. Instead, find 
out which methods from the interface you have failed to implement within your class and code those methods. 


Q When you create a class and use the imp] ements clause to implement an interface but fail to code one of the 


Java has many built-in interfaces with names such as Serializable, Runnable, Externalizable, 
GY and Cloneab1e. See the documentation at the Java Web site for more details. 


Creating Interfaces to Store Related Constants 


Interfaces can contain data fields, but they must be public, static, and final. It makes sense 
that interface data must not be private because interface methods cannot contain method 
bodies; without public method bodies, you have no way to retrieve private data. It also 
makes sense that the data fields in an interface are static because you cannot create interface 
objects. Finally, it makes sense that interface data fields are final because, without methods 
containing bodies, you have no way, other than at declaration, to set the data fields’ values, 
and you have no way to change them. 


Your purpose in creating an interface containing constants is to provide a set of data that a 
number of classes can use without having to redeclare the values. For example, the interface 
class in Figure 11-29 provides a number of constants for a pizzeria. Any class written for the 
pizzeria can implement this interface and use the permanent values. Figure 11-30 shows an 
example of one application that uses each value, and Figure 11-31 shows the output. The 
application in Figure 11-30 only needs a declaration for the current special price; all the 
constants, such as the name of the pizzeria, are retrieved from the interface. 
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public interface PizzaConstants 
{ 
public static final int SMALL_DIAMETER = 12; 
public static final int LARGE_DIAMETER = 16; 
580 public static final double TAX_RATE = 0.07; 
public static final String COMPANY = "Antonio's Pizzeria"; 











Figure 11-29 The PizzaConstants interface 








public class PizzaDemo implements PizzaConstants 
{ 
public static void main(String[] args) 
{ 
double specialPrice = 11.25; 
System.out.printInC"Welcome to " + COMPANY) ; 
System.out.printIn("We are having a special offer:\na " + 
SMALL_DIAMETER + " inch pizza with four toppings\nor a" + 
LARGE_DIAMETER + 
"inch pizza with one topping\nfor only $" + specialPrice); 
System.out.printInC"wWith tax, that is only $" + 
(specialPrice + specialPrice * TAX_RATE)); 








Figure 11-30 The PizzaDemo application 


@ 
ws corns ror I = 


C:\Java>java PizzaDemo 

Welcome to Antonio’s Pizzeria 

We are having a special offer: 

a 12 inch pizza with four toppings 
* a 16 inch pizza with one topping 
* only $11.25 

With tax. that is only $12.6375 








C:\Java>_ 











Figure 11-31 Output of the PizzaDemo application 


ere) . 
Eu Watch the video Interfaces. 
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Creating and Using Interfaces 





1. Java's capability to inherit from more than one class is called multiple inheritance. 581 





2. All of the methods in an interface are implicitly public and abstract, and all of 
its data items (if any) are implicitly public, static, and final. 


3. When a class inherits from another, the child class can use the nonprivate, 
nonoverridden members of its parent’s class, but when a class uses an 
interface, it must implement its own version of each method. 
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<a You Do It 


Using an Interface 


In this section, you create an Insured interface for use with classes that represent 
objects that can be insured. For example, you might use this interface with classes 
such as Jewelry Or House. Also in this section, you extend Vehicle to create an 
InsuredCar Class that implements the Insured interface, and then you write a short 
program that instantiates an InsuredCar object. 


1. Open a new file in your text editor, and type the following Insured interface. 
A concrete class that implements Insured will be required to contain 
setCoverage() and getCoverage() methods. 


public interface Insured 
{ 
public void setCoverageQ ; 
public int getCoverage() ; 
} 


2. Save the file as Insured.java and compile it. 


3. Open anew file in your text editor, and start the InsuredCar class that 
extends Vehicle and implements Insured: 


import javax.swing.*; 
public class InsuredCar extends Vehicle implements Insured 


t (continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce! earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 





CHAPTER 11 Advanced Inheritance Concepts 


582 





(continued) 


Add a variable to hold the amount covered by the insurance: 
private int coverage; 


Add a constructor that calls the Vehicle superclass constructor, passing 
arguments for the InsuredCar’s power source and number of wheels. 


public InsuredCar() 
{ 
super("gas", 4); 
setCoverage() ; 


} 


Implement the setPrice() method required by the Vehicle class. The method 
accepts the car’s price from the user and enforces a maximum value of 
$60,000. 


public void setPrice() 
{ 
String entry; 
final int MAX = 60000; 
entry = JOptionPane.showInputDialog 
(null, "Enter car price "); 
price = Integer.parseInt(entry) ; 
if(price > MAX) 
price = MAX; 
} 


Implement the setCoverage() and getCoverage() methods required by the 
Insured Class. The setCoverage() method sets the coverage value for an 
insured car to 90 percent of the car’s price: 


public void setCoverage() 


{ 
} 


public int getCoverage() 
{ 


} 
Create a toString() method, followed by a closing brace for the class: 


coverage = Cint)(price * 0.9); 


return coverage; 


public String toStringQO 


{ 
return("The insured car is powered by " + getPowerSource() + 
"; it has " + getWheels() + " wheels, costs $" + 
getPriceQ) + " and is insured for $" + getCoverageQ); 
} 


(continues) 
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(continued) 


9. Save the file as InsuredCar.java and compile it. 


10. Create a demonstration program that instantiates an InsuredCar object and 
displays its values as follows: 583 








import javax.swing.*; 
public class InsuredCarDemo 


{ 
public static void main(String[] args) 
{ 
InsuredCar myCar = new InsuredCar(Q); 
JOptionPane.showMessageDialog(null, 
myCar.toStringQ); 
} 
} 


11. Save the file as InsuredCarDemo.java. Compile and execute it. You will 
be prompted to enter the car’s price. Figure 11-32 shows the output during 
a typical execution. 








@ The insured car is powered by gas; it has 4 wheels, costs $24000 and is insured for $21600 





Figure 11-32 Output of the InsuredCarDemo program 


Creating and Using Packages 


Throughout most of this book, you have imported packages into your programs. As you 
learned in Chapter 4, a package is a named collection of classes; for example, the java. lang 
package contains fundamental classes and is automatically imported into every program you 
write. You also have created classes into which you explicitly imported optional packages 
such as java.util and javax.swing. When you create classes, you can place them in 
packages so that you or other programmers can easily import your related classes into new 
programs. Placing classes in packages for other programmers increases the classes’ reusability. 
When you create a number of classes that inherit from each other, as well as multiple 
interfaces that you want to implement with these classes, you often will find it convenient to 
place these related classes in a package. 
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related classes at once. In Chapter 3, you learned that if you do not use one of the three access specifiers 
public, private, or protected for a class, then it has default access, which means that the unmodified 
class is accessible to any other class in the same package. 


Q Creating packages encourages others to reuse software because it makes it convenient to import many 


584 





When you create professional classes for others to use, you most often do not want to provide 
the users with your source code in the files that have java extensions. You expend significant 
effort developing workable code for your programs, and you do not want other programmers to 
be able to copy your programs, make minor changes, and market the new product themselves. 
Rather, you want to provide users with the compiled files that have .class extensions. These 
are the files the user needs to run the program you have developed. Likewise, when other 
programmers use the classes you have developed, they need only the completed compiled 
code to import into their programs. The .class files are the files you place in a package so 
other programmers can import them. 


(JAR) file. JAR files compress the data they store, which reduces the size of archived class files. The JAR 


In the Java programming language, a package or class library is often delivered to users as a Java ARchive 
Y format is based on the popular Zip file format. 


If you do not specify a package for a class, it is placed in an unnamed default package. 

A class that will be placed in a nondefault package for others to use must be public. Ifa 
class is not public, it can be used only by other classes within the same package. To place 
a class in a package, you include a package declaration at the beginning of the source code file 
that indicates the folder into which the compiled code will be placed. When a file contains 
a package declaration, it must be the first statement in the file (excluding comments). 

If there are import declarations, they follow the package declaration. Within the file, the 
package statement must appear outside the class definition. The package statement, import 
statements, and comments are the only statements that appear outside class definitions in 
Java program files. 


For example, the following statement indicates that the compiled file should be placed in a 
folder named com.course.animals: 


package com.course.animals; 


That is, the compiled file should be stored in the animals subfolder inside the course subfolder 
inside the com subfolder (or com\course\animals). The pathname can contain as many levels 
as you want. 


When you compile a file that you want to place in a package, you can copy or move the 
compiled .class file to the appropriate folder. Alternatively, you can use a compiler option 
with the javac command. The -d (for directory) option indicates that you want to place the 
generated .class file in a folder. For example, the following command indicates that the 
compiled Animal.java file should be placed in the directory indicated by the import statement 
within the Animal.java file: 


javac -d . Animal.java 
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The dot (period) in the compiler command indicates that the path shown in the package 
statement in the file should be created within the current directory. 


If the Animal class file contains the statement package com.course.animals;, the Animal. 
class file is placed in C:\com\course\animals. If any of these subfolders do not exist, Java 
creates them. Similarly, if you package the compiled files for Dog.java, Cow.java, and so on, 
future programs need only use the following statements to be able to use all the related 
classes: 
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import com.course.animals.Dog; 
import com.course.animals.Cow; 


Because Java is used extensively on the Internet, it is important to give every package a unique 
name. The creators of Java have defined a package-naming convention that uses your Internet 
domain name in reverse order. For example, if your domain name is course.com, you begin all 
of your package names with com.course. Subsequently, you organize your packages into 
reasonable subfolders. 


Creating packages using Java’s naming convention helps avoid naming conflicts—different 
programmers might create classes with the same name, but they are contained in different 
packages. Class-naming conflicts are sometimes called collisions. Because of packages, you 
can create a class without worrying that its name already exists in Java or in packages 
distributed by another organization. For example, if your domain name is course.com, then 
you might want to create a class named Scanner and place it in a package named com. 
course. input. The fully qualified name of your Scanner class is com. course. input .Scanner, 
and the fully qualified name of the built-in Scanner class is java.util.Scanner. 


Creating and Using Packages 


1. Typically, you place .class files in a package so other programmers can import 
them into their programs. 


2. Aclass that will be placed in a package for others to use must be protected So 
that others cannot read your source code. 


3. Java's creators have defined a package-naming convention in which you use 
your Internet domain name in reverse order. 
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an You Do It 


Creating a Package 


Next, you place the Vehicle family of classes into a package. Assume you work 
for an organization that sponsors a Web site at vehicleswesell.com, so you 

name the package com. vehicleswesel11. First, you must create a folder named 
VehiclePackage in which to store your project. You can use any technique that is 
familiar to you. For example, in Windows, you can double-click Computer, navigate 
to the device or folder where you want to store the package, right-click, click New, 
click Folder, replace “New Folder” with the new folder name (VehiclePackage), and 
press Enter. Alternatively, from the command prompt, you can navigate to the drive 
and folder where you want the new folder to reside by using the following 
commands: 


elf the command prompt does not indicate the storage device you want, type the 
name of the drive and a colon to change the command prompt to a different 
device. For example, to change the command prompt to the F drive on your 
system, type F:. 


e lf the directory is not the one you want, type cd\ to navigate to the root directory. 
The cd command stands for “change directory,” and the backslash indicates the 
root directory. Then type cd followed by the name of the subdirectory you want. 
You can repeat this command as many times as necessary to get to the correct 
subdirectory if it resides many levels down the directory hierarchy. 


Next, you can place three classes into a package. 
1. Open the Vehicle.java file in your text editor. 
2. As the first line in the file, insert the following statement: 
package com.vehicleswesell.vehicle; 
3. Save the file as Vehicle.java in the VehiclePackage folder. 


4. Atthe command line, at the prompt for the VehiclePackage folder, compile 
the file using the following command: 


javac -d . Vehicle. java 


Be certain that you type a space between each element in the command, 
including surrounding the dot. Java creates a folder named 
com\wehicleswesell\vehicle within the directory from which you compiled 
the program, and the compiled Vehicle.class file is placed in this folder. 


(continues) 


(continued) 


If you see a list of compile options when you try to compile the file, you did not type the spaces within 
the command correctly. Repeat Step 4 to compile again. 

The development tool GRASP generates software visualizations to make programs easier to understand. A 
copy of this tool is included with your downloadable student files. If you are using jGRASP to compile your 
Java programs, you also can use it to set compiler options. To set a compiler option to —d, do the following: 
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e Open a jGRASP project workspace. Click the Settings menu, point to 
Compiler Settings, and then click Workspace. The Settings for workspace 
dialog box appears. 


e Under the FLAGS or ARGS section of the dialog box, click the dot inside 
the square next to the Compile option and enter the compiler option (-d). 
Then click the Apply button. 


e Click the OK button to close the dialog box, and then compile your 
program as usual. 


5. Examine the folders on your storage device, using any operating system program 
with which you are familiar. For example, if you are compiling at the DOS 
command line, type dir at the command-ine prompt to view the folders stored 
in the current directory. You can see that Java created a folder named com. 

(If you have too many files and folders stored, it might be difficult to locate the 
com folder. If so, type dir com*.* to see all files and folders in the current 
folder that begin with “com”.) Figure 11-33 shows the command to compile the 
Vehicle class and the results of the dir command, including the com folder. 





r 


fay Command Prompt 






C:\Java\WehiclePackage>javac -d . Vehicle.java 


C:\JavaWehic lePackage >dir 
Volume in drive C is O§ 
Volume Serial Number is 92'7'7-CEAD 


Directory of C:\Java\WehiclePackage 


68/18/2613 65:66 PM <DIR> 

m68/18/2613 65:66 PM <DIR> — 
68/18/2613 65:66 PM <DIR> com 
98/18/2613 64:59 PM 688 Vehicle. java 
1 File<s> 688 bytes 

3 Dirts> 74,116.796,.416 bytes free 


C:\JavaWehic lePackage> 





Figure 11-33 Compiling the Vehicle.java file in a package and viewing the results 


(continues) 
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10. 


11. 


(continued) 


Alternatively, to view the created folders in a Windows operating system, you 
can double-click Computer, double-click the appropriate storage device, and 
locate the com folder. Within the com folder is a vehicleswesell folder, and 
within vehicleswesell is a vehicle folder. The Vehicle.class file is within the 
vehicle subfolder and not in the same folder as the .java source file where it 
ordinarily would be placed. 


If you cannot find the com folder on your storage device, you probably are not looking in the same folder 
where you compiled the class. Repeat Steps 4 and 5, but be certain that you first change to the command 
prompt for the directory where your source code file resides. 


You could now delete the copy of the Vehicle.java file from the VehiclePackage 
folder (although you most likely want to retain a copy elsewhere). There is no 
further need for this source file in the folder you will distribute to users because 
the compiled .class file is stored in the com\vehiclesweselNvehicle folder. Don’t 
delete the copy of your code from its original storage location; you might want to 
retain a copy of the code for modification later. 


Open the Sailboat.java file in your text editor. For the first line in the file, insert 
the following statement: 


package com.vehicleswesell.vehicle; 


Save the file in the same directory as you saved Vehicle.java. At the command 
line, compile the file using the following command: 


javac -d . Sailboat.java 


Then you can delete the Sailboat.java source file from the VehiclePackage folder 
(not from its original location—you want to retain a copy of your original code). 


Repeat Steps 7 and 8 to perform the same operations using the Bicycle.java file. 


Open the VehicleDatabase.java file in your text editor. Insert the following 
statements at the top of the file: 


import com.vehicleswesell.vehicle.Vehicle; 
import com.vehicleswesell.vehicle.Sailboat; 
import com.vehicleswesell.vehicle.Bicycle; 


Save the file as VehiclePackage\VehicleDatabase.java. Compile the file, and 
then run the program. The program’s output should be the same as it was before 
you added the import statements. Placing the Vehicle-related class files in a package 
is not required for the VehicleDatabase program to execute correctly; you ran it 

in exactly the same manner before you learned about creating packages. 


Placing classes in packages gives you the ability to more easily isolate and 
distribute files. 
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Don't Do It 


e Don't write a body for an abstract method. 
e Don't forget to end an abstract method header with a semicolon. 


e Don't forget to override any abstract methods in any subclasses you derive. 589 








e Don't mistakenly overload an abstract method instead of overriding it; the subclass 
method must have the same parameter list as the parent’s abstract method. 


e Don't try to instantiate an abstract class object. 
e Don’t forget to override all the methods in an interface that you implement. 


e When you create your own packages, don’t try to use the wildcard format to import 
multiple classes. This technique works only with built-in packages. 





Key Terms 


Concrete classes are nonabstract classes from which objects can be instantiated. 


An abstract class is one from which you cannot create any concrete objects but from which 
you can inherit. 


Virtual classes is the name given to abstract classes in other programming languages, such as 
C++. 


An abstract method is declared with the keyword abstract. It is a method with no body—no 
curly braces and no method statements—just a return type, a method name, an optional 
argument list, and a semicolon. You are required to code a subclass method to override the 
empty superclass method that is inherited. 


Dynamic method binding is the ability of an application to select the correct method during 
program execution. 










Late method binding is another term for dynamic method binding. 


Static or fixed method binding is the opposite of dynamic method binding; it occurs when a 
method is selected when the program compiles rather than while it is running. 


Ad-hoc polymorphism occurs when a single method name can be used with a variety of data 
types because various implementations exist; it is another name for method overloading. 


Pure polymorphism or inclusion polymorphism occurs when a single method implementation 
can be used with a variety of related objects because they are objects of subclasses of the 
parameter type. 
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The Object class is defined in the java. lang package that is imported automatically 
every time you write a program; it includes methods that you can use or override. When 
you define a class, if you do not explicitly extend another class, your class is an extension 
of the Object class. 


590 The Object class toString() method converts an Object into a String that contains 
information about the Object. 





A hash code is a calculated number used to identify an object. 


The Object class equals() method takes a single argument, which must be the same type as 
the type of the invoking object, and returns a Boolean value indicating whether two object 
references are equal. 


Multiple inheritance is the capability to inherit from more than one class. 


An interface looks much like a class, except that all of its methods must be abstract and all of 
its data (if any) must be static final; it declares method headers but not the instructions 
within those methods. 


A Java ARchive (JAR) file compresses the stored data. 


A default package is the unnamed one in which a class is placed if you do not specify a 
package for the class. 


Collision is a term that describes a class-naming conflict. 


Chapter Summary 


e Aclass that you create only to extend from, but not to instantiate from, is an abstract 
class. Usually, abstract classes contain one or more abstract methods—methods with no 
method statements. You must code a subclass method to override any inherited abstract 
superclass method. 


e When you create a superclass and one or more subclasses, each object of the subclass “is 
a” superclass object, so you can convert subclass objects to superclass objects. The ability 
of a program to select the correct method during execution based on argument type is 
known as dynamic method binding. You can create an array of superclass object 
references but store subclass instances in it. 







e Every class in Java is an extension of the Object class, whether or not you explicitly extend 
it. Every class inherits several methods from Object, including toString), which 
converts an Object into a String, and equals(Q), which returns a boolean value 
indicating whether one object is a reference to another. You can override these methods 
to make them more useful for your classes. 
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e When you create a useful, extendable superclass, you save development time because 
much of the code needed for the class has already been written. In addition, you save 
testing time and, because the superclass code is reliable, you reduce the time it takes to 
learn the new class features. You also maintain superclass integrity. 


e Aninterface is similar to a class, but all of its methods are implicitly public and abstract, and 
all of its data (if any) is implicitly public, static, and final. When you create a class that uses 
an interface, you include the keyword implements and the interface name in the class header. 
This notation serves to require class objects to include code for all the methods in the interface. 
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e Abstract classes and interfaces are similar in that you cannot instantiate concrete objects 
from either. Abstract classes differ from interfaces because abstract classes can contain 
nonabstract methods, but all methods within an interface must be abstract. A class can 
inherit from only one abstract superclass, but it can implement any number of interfaces. 


e You can place classes in packages so you or other programmers can easily import related 
classes into new classes. The convention for naming packages uses Internet domain 
names in reverse order to ensure that your package names do not conflict with those of 
any other Internet users. 


Review Questions 


1. Parent classes are ________ than their child classes. 
a. less specific c. easier to understand 
b. more specific d. more cryptic 


2. Abstract classes differ from other classes in that you 


must not code any methods within them 
must instantiate objects from them 
cannot instantiate objects from them 


ao F PS 


cannot have data fields within them 


3. Abstract classes can contain 












a. abstract methods c. both of the above 
b. nonabstract methods d. none of the above 


4, An abstract class Product has two subclasses, Perishable and NonPerishable. 
None of the constructors for these classes requires any arguments. Which of the 
following statements is legal? 

a. Product myProduct = new Product(); 

b. Perishable myProduct = new Product(); 

c. NonPerishable myProduct = new NonPerishable(); 
d. none of the above 
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5. An abstract class Employee has two subclasses, Permanent and Temporary. The 
Employee class contains an abstract method named setType(). Before you can 
instantiate Permanent and Temporary objects, which of the following statements 
must be true? 


a. You must code statements for the setType() method within the Permanent 


592 
class. 





b. You must code statements for the setType() method within both the 
Permanent and Temporary classes. 


c. You must not code statements for the setType() method within either the 
Permanent or Temporary class. 


d. You can code statements for the setType() method within the Permanent 
class or the Temporary class, but not both. 


6. When you create a superclass and one or more subclasses, each object of the 


subclass ___________ superclass object. 
a. overrides the c. “is not a” 
b. “is a” d. isanew 


7. Which of the following statements is true? 


a. Superclass objects are members of their subclass. 
b. Superclasses can contain abstract methods. 
c. You can create an abstract class object using the new operator. 
d. An abstract class cannot contain an abstract method. 
8. When you create a _____________ in Java, you create a variable name in which 
you can hold the memory address of an object. 
a. field c. recommendation 
b. pointer d. reference 


9. An application’s ability to select the correct subclass method to execute is known 









as____________ method binding. 
a. polymorphic c. early 
b. dynamic d. intelligent 


10. Which statement creates an array of five references to an abstract class named 
Currency? 

Currency[] = new Currency[5]; 

Currency[] currencyref = new Currency[5]; 


Currency[5] currencyref = new Currency[5]; 


a0 TF PS 


Currency[5] = new Currency[5]; 
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11. You__________ override the toStringQ method in any class you create. 
a. cannot c. must 
b. can d. must implement StringListener to 


12. The Object class equals() method takes 593 








no arguments 
one argument 
two arguments 


ao fF 


as many arguments as you need 


13. Assume the following statement appears in a working Java program: 
if(thing.equals(anotherThing)) x = 1; 
You know that 


a. thing is an object of the Object class 
b. anotherThing is the same type as thing 
c. Both of the above are correct. 
d. None of the above are correct. 


14. The Object class equals() method considers two object references to be equal if 
they have the same 


a. value in all data fields 
b. value in any data field 
c. data type 
d. memory address 
15. Java subclasses have the ability to inherit from _________ parent class(es). 
a. one c. multiple 
b. two d. no 


16. The alternative to multiple inheritance in Java is known as a(n) 








a. superobject c. interface 
b. abstract class d. none of the above 


17. When you create a class that uses an interface, you include the 


keyword _________ and the interface’s name in the class header. 
a. interface c. accouterments 
b. implements d. listener 
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18. You can instantiate concrete objects from a(n) 
a. abstract class c. either a or b 
b. interface d. neither a nor b 
19. In Java, a class can 
a. inherit from one abstract superclass at most 
b. implement one interface at most 
c. bothaandb 
d. neither a nor b 
20. When you want to provide some data or methods that subclasses can inherit, 
but you want the subclasses to override some specific methods, you should write 
a(n) 
a. abstract class c. final superclass 
b. interface d. concrete object 
Exercises 


=) Programming Exercises 


as 


a. Create an abstract class named Book. Include a String field for the book’s title 
and a double field for the book’s price. Within the class, include a constructor 
that requires the book title, and add two get methods—one that returns the title 
and one that returns the price. Include an abstract method named setPrice(). 
Create two child classes of Book: Fiction and NonFiction. Each must include a 
setPrice() method that sets the price for all Fiction Books to $24.99 and for 
all NonFiction Books to $37.99. Write a constructor for each subclass, and 
include a call to setPriceQ within each. Write an application demonstrating 
that you can create both a Fiction and a NonFiction Book and display their 
fields. Save the files as Book.java, Fiction.java, NonFiction.java, and 
UseBook.java. 


b. Write an application named BookArray in which you create an array that holds 


10 Books, some Fiction and some NonFiction. Using a for loop, display details 
about all 10 books. Save the file as BookArray.java. 
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2. a. The Talk-A-Lot Cell Phone Company provides phone services for its 
customers. Create an abstract class named PhoneCal1 that includes a String 
field for a phone number and a double field for the price of the call. Also 
include a constructor that requires a phone number parameter and that sets 
the price to 0.0. Include a set method for the price. Also include three abstract 
get methods—one that returns the phone number, another that returns the 595 
price of the call, and a third that displays information about the call. Create 
two child classes of PhoneCal11: IncomingPhoneCal1 and OutgoingPhoneCal1. 

The IncomingPhoneCal1 constructor passes its phone number parameter to 
its parent’s constructor and sets the price of the call to 0.02. The method that 
displays the phone call information displays the phone number, the rate, and 
the price of the call (which is the same as the rate). The OutgoingPhoneCal1 
class includes an additional field that holds the time of the call in minutes. The 
constructor requires both a phone number and the time. The price is 0.04 per 
minute, and the display method shows the details of the call, including the 
phone number, the rate per minute, the number of minutes, and the total 
price. Write an application that demonstrates you can instantiate and display 
both IncomingPhoneCal1 and OutgoingPhoneCal1 objects. Save the files as 
PhoneCall.java, IncomingPhoneCall.java, OutgoingPhoneCall.java, and 
DemoPhoneCalls.java. 








b. Write an application in which you assign data to a mix of 10 IncomingPhoneCa11 
and OutgoingPhoneCal1 objects into an array. Use a for loop to display the 
data. Save the file as PhoneCallArray.java. 


3. Create an abstract Auto class with fields for the car make and price. Include get 
and set methods for these fields; the setPrice() method is abstract. Create two 
subclasses for individual automobile makers (for example, Ford or Chevy), and 
include appropriate setPrice() methods in each subclass (for example, $20,000 or 
$22,000). Finally, write an application that uses the Auto class and subclasses to 
display information about different cars. Save the files as Auto.java, Ford.java, 
Chevy.java, and UseAuto.java. 


4, Create an abstract Division class with fields for a company’s division name and 
account number, and an abstract display() method. Use a constructor in the 
superclass that requires values for both fields. Create two subclasses named 
InternationalDivision and DomesticDivision. The InternationalDivision 
includes a field for the country in which the division is located and a field for 
the language spoken; its constructor requires both. The DomesticDivision 
includes a field for the state in which the division is located; a value for this field 
is required by the constructor. Write an application named UseDivision that 
creates InternationalDivision and DomesticDivision objects for two different 
companies and displays information about them. Save the files as Division.java, 
InternationalDivision.java, DomesticDivision.java, and UseDivision.java. 
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5. Create an abstract class named Element that holds properties of elements, including 
their symbol, atomic number, and atomic weight. Include a constructor that requires 
values for all three properties and a get method for each value. (For example, the 
symbol for carbon is C, its atomic number is 6, and its atomic weight is 12.01. You 
can find these values by reading a periodic table in a chemistry reference or by 

596 searching the Web.) Also include an abstract method named describeElement(). 





Create two extended classes named MetalElement and NonMetalElement. Each 
contains a describeElement() method that displays the details of the element and a 
brief explanation of the properties of the element type. For example, metals are good 
conductors of electricity, while nonmetals are poor conductors. Write an application 
named ElementArray that creates and displays an array that holds at least two 
elements of each type. Save the files as Element.java, MetalElement.java, 
NonMetalElement.java, and ElementArray.java. 


6. Create a class named NewspaperSubscriber with fields for a subscriber’s street 
address and the subscription rate. Include get and set methods for the subscriber’s 
street address, and include get and set methods for the subscription rate. The set 
method for the rate is abstract. Include an equals( method that indicates two 
Subscribers are equal if they have the same street address. Create child classes 
named SevenDaySubscriber, WeekdaySubscriber, and WeekendSubscriber. Each 
child class constructor sets the rate as follows: SevenDaySubscribers pay $4.50 per 
week, WeekdaySubscribers pay $3.50 per week, and WeekendSubscribers pay 
$2.00 per week. Each child class should include a toString() method that returns 
the street address, rate, and service type. Write an application named Subscribers 
that prompts the user for the subscriber’s street address and requested service, and 
then creates the appropriate object based on the service type. Do not let the user 
enter more than one subscription type for any given street address. Save the files as 
NewspaperSubscriber.java, WeekdaySubscriber.java, WeekendSubscriber. 
java, SevenDaySubscriber.java, and Subscribers.java. 


7. Picky Publishing House publishes stories in three categories and has strict require- 
ments for page counts in each category. Create an abstract class named Story that 
includes a story title, an author name, a number of pages, and a String message. 
Include get and set methods for each field. The method that sets the number of pages 
is abstract. Also include constants for the page limits in each category. Create three 
Story subclasses named Novel, Novella, and ShortStory, each with a unique 
setPages() method. A Novel must have more than 100 pages, a Novella must have 
between 50 and 100 pages inclusive, and a ShortStory must have fewer than 
50 pages. If the parameter passed to any of the set methods in the child class is out of 
range, set the page value but also create and store a message that indicates how many 
pages must be added or cut to satisfy the rules for the story type. Write an application 
named StoryDemo that creates an array of at least six objects to demonstrate how 
the methods work for objects created both with valid and invalid page counts for 
each story type. For each story, display the title, author, page count, and message 
if any was generated. Figure 11-34 shows a sample execution. Save the files as 
Story.java, Novel.java, Novella.java, ShortStory.java, and StoryDemo.java. 
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fa Command Prompt 


publishing the story The Gift of the Magi by 0. Henry. 597 
ory has 52 pages. 
3 pages must be cut to qualify as a short story. 








are publishing the story The Old Man and the Sea by E. Hemingway. 
The story has 97 pages. 


are publishing the story Of Mice and Men by J. Steinbeck. 
The story has 107 pages. 
7? pages must be cut to qualify as a novella. 


are publishing the story Goodbye. Columbus by P. Roth. 
The story has 46 pages. 
4 pages must be added to qualify as a novella. 


are publishing the story Breakfast at Tiffany’s by T. Capote. 
The story has 1206 pages. 

are publishing the story Animal Farm by G. Orwell. 

The story has 98 pages. 

3 pages must be added to qualify as a novel. 


NC =\Jdava> 

















Figure 11-34 Typical execution of the StoryDemo application 


8. a. Create an interface named Turner, with a single method named turn(). Create a 
class named Leaf that implements turn to display “Changing colors”. Create a 
class named Page that implements turn() to display “Going to the next page”. 
Create a class named Pancake that implements turn() to display “Flipping”. 
Write an application named DemoTurners that creates one object of each of these 
class types and demonstrates the turn() method for each class. Save the files as 
Turner.java, Leaf.java, Page.java, Pancake.java, and DemoTurners.java. 


b. Think of two more objects that use turn(), create classes for them, and then 
add objects to the DemoTurners application, renaming it DemoTurners2.java. 
Save the files, using the names of new objects that use turn(Q). 















9. Write an application named UseInsurance that uses an abstract Insurance class 
and Health and Life subclasses to display different types of insurance policies 
and the cost per month. The Insurance class contains a String representing the 
type of insurance and a double that holds the monthly price. The Insurance class 
constructor requires a String argument indicating the type of insurance, but the 
Life and Health class constructors require no arguments. The Insurance class 
contains a get method for each field; it also contains two abstract methods named 
setCost() and display(). The Life class setCost() method sets the monthly fee 
to $36, and the Health class sets the monthly fee to $196. Write an application 
named UseInsurance that prompts the user for the type of insurance to be 
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11. 


12. 


13. 


14. 











15. 


displayed, and then create the appropriate object. Save the files as Life.java, 
Health.java, Insurance.java, and UseInsurance.java. 


Create an abstract class called GeometricFigure. Each figure includes a height, a 
width, a figure type, and an area. Include an abstract method to determine the area of 
the figure. Create two subclasses called Square and Triangle. Create an application 
that demonstrates creating objects of both subclasses, and store them in an array. 
Save the files as GeometricFigure.java, Square.java, Triangle.java, and 
UseGeometric.java. 


Modify Exercise 10, adding an interface called SidedObject that contains a method 
called displaySides(); this method displays the number of sides the object possesses. 
Modify the GeometricFigure subclasses to include the use of the interface to display 
the number of sides of the figure. Create an application that demonstrates the use of 
both subclasses. Save the files as GeometricFigure2.java, Square2.java, Triangle2. 
java, SidedObject.java, and UseGeometric2.java. 


Create an interface called Player. The interface has an abstract method called playQ 
that displays a message describing the meaning of “play” to the class. Create classes 
called Child, Musician, and Actor that all implement Player. Create an application 
that demonstrates the use of the classes. Save the files as Player.java, Child.java, 
Actor.java, Musician.java, and UsePlayer.java. 


Create an abstract class called Student. The Student class includes a name and a 
Boolean value representing full-time status. Include an abstract method to determine 
the tuition, with full-time students paying a flat fee of $2,000 and part-time students 
paying $200 per credit hour. Create two subclasses called FullTime and PartTime. 
Create an application that demonstrates how to create objects of both subclasses. 
Save the files as Student.java, FullTime.java, PartTime.java, and UseStudent.java. 


Create a Building class and two subclasses, House and School. The Building 
class contains fields for square footage and stories. The House class contains 
additional fields for number of bedrooms and baths. The Schoo! class contains 
additional fields for number of classrooms and grade level (for example, elementary 
or junior high). All the classes contain appropriate get and set methods. Place the 
Building, House, and School classes in a package named com.course.buildings. 
Create an application that declares objects of each type and uses the package. 
Save the necessary files as Building.java, House.java, School.java, and 
CreateBuildings.java. 


Sanchez Construction Loan Co. makes loans of up to $100,000 for construction 
projects. There are two categories of Loans—those to businesses and those to 
individual applicants. 


Write an application that tracks all new construction loans. The application must also 
calculate the total amount owed at the due date (original loan amount + loan fee). 
The application should include the following classes: 
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e lLoan—A public abstract class that implements the LoanConstants interface. A 
Loan includes a loan number, customer last name, amount of loan, interest rate, 
and term. The constructor requires data for each of the fields except interest 
rate. Do not allow loan amounts over $100,000. Force any loan term that is not 
one of the three defined in the LoanConstants class to a short-term, one-year 
loan. Create a toString() method that displays all the loan data. 599 








e LoanConstants—A public interface class. LoanConstants includes constant 
values for short-term (one year), medium-term (three years), and long-term 
(five years) loans. It also contains constants for the company name and the 
maximum loan amount. 


e BusinessLoan—A public class that extends Loan. The BusinessLoan constructor 
sets the interest rate to 1 percent over the current prime interest rate. 


e PersonalLoan—A public class that extends Loan. The PersonalLoan constructor 
sets the interest rate to 2 percent over the current prime interest rate. 


e CreateLoans—An application that creates an array of five Loans. Prompt the 
user for the current prime interest rate. Then, in a loop, prompt the user for a 
loan type and all relevant information for that loan. Store the created Loan 
objects in the array. When data entry is complete, display all the loans. 


Save the files as Loan.java, LoanConstants.java, BusinessLoan.java, PersonalLoan. 
java, and CreateLoans.java. 


KS Debugging Exercises 


1. Each of the following files in the Chapter11 folder of your downloadable student files 
has syntax and/or logic errors. In each case, determine the problem and fix the 
program. After you correct the errors, save each file using the same filename preceded 
with Fix. For example, DebugEleven1.java will become FixDebugEleven1 java. 







a. DebugElevenl.java 
b. DebugEleven2.java 
c. DebugEleven3.java 
d. DebugEleven4.java 
e. Three other Debug files in the Chapter11 folder 


op Game Zone 


1. In Chapter 10, you created an Alien class as well as two descendant classes, Martian 
and Jupiterian. Because you never create any “plain” Alien objects, alter the Alien 
class so it is abstract. Verify that the Martian and Jupiterian classes can still inherit 
from Alien and that the CreateAliens program still works correctly. Save the 
altered Alien file as Alien.java. 
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2. a. Create an abstract CardGame class similar to the one described in this chapter. 
The class contains a “deck” of 52 playing cards that uses a Card class to hold a suit 
and value for each Card object. It also contains an integer field that holds the 
number of cards dealt to a player in a particular game. The class contains a 
constructor that initializes the deck of cards with appropriate values (e.g., 

“King of Hearts”), and a shuffle() method that randomly arranges the 
positions of the Cards in the array. The class also contains two abstract methods: 
displayDescription(), which displays a brief description of the game in each 
of the child classes, and deal(), which deals the appropriate number of Card 
objects to one player of a game. Save the file as CardGame.java. 
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b. Create two child classes that extend CardGame. You can choose any games you 
prefer. For example, you might create a Poker class or a Bridge class. Create a 
constructor for each child class that initializes the field that holds the number 
of cards dealt to the correct value. (For example, in standard poker, a player 
receives five cards, but in bridge, a player receives 13.) Create an appropriate 
displayDescription() and deal() method for each child class. Save each file 
using an appropriate name—for example, Poker.java or Bridge.java. 


c. Create an application that instantiates one object of each game type and 
demonstrates that the methods work correctly. Save the application as 
PlayCardGames.java. 


Case Problems 





1. a. Inprevious chapters, you have created several classes for Carly’s Catering. Now, 
create a new abstract class named Employee. The class contains data fields for 
an employee’s ID number, last name, first name, pay rate, and job title. The class 
contains get and set methods for each field; the set methods for pay rate and job 
title are abstract. Save the file as Employee.java. 


b. Create three classes that extend Employee named Waitstaff, Bartender, and 
Coordinator. The method that sets the pay rate in each class accepts a 
parameter and assigns it to the pay rate, but no Waitstaff employee can have a 
rate higher than 10.00, no Bartender can have a rate higher than 14.00, and no 
Coordinator can have a rate higher than 20.00. The method that sets the job 
title accepts no parameters—it simply assigns the string “waitstaff”, “bartender”, 
or “coordinator” to the object appropriately. Save the files as Waitstaff.java, 
Bartender.java, and Coordinator.java. 















c. In Chapter 10, you created a DinnerEvent class that holds event information, 
including menu choices. Modify the class to include an array of 15 Employee 
objects representing employees who might be assigned to work at a 
DinnerEvent. Include a method that accepts an Employee array parameter 
and assigns it to the Employee array field, and include a method that returns the 
Employee array. The filename is DinnerEvent.java. 
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d. Write an application that declares a DinnerEvent object, prompts the user for 
an event number, number of guests, menu options, and contact phone number, 
and then assigns them to the object. Also prompt the user to enter data for as 
many Employees as needed based on the number of guests. A DinnerEvent 
needs one Waitstaff Employee for every event, two if an event has 10 guests or 
more, three if an event has 20 guests or more, and so on. A DinnerEvent also 601 
needs one Bartender for every 25 guests and one Coordinator no matter how 
many guests attend. All of these Employees should be stored in the Employee 
array in the DinnerEvent object. (For many events, you will have empty 
Employee array positions.) After all the data values are entered, pass the 
DinnerEvent object to a method that displays all of the details for the event, 
including all the details about the Employees assigned to work. Save the 
program as StaffDinnerEvent.java. 








2. a. In previous chapters, you have created several classes for Sammy’s Seashore 
Supplies. Now, Sammy has decided to restructure his rates to include different 
fees for equipment types in addition to the fees based on rental length and to 
charge for required lessons for using certain equipment. Create an abstract 
class named Equipment that holds fields for a numeric equipment type, a 
String equipment name, and a fee for renting the equipment. Include a final 
array that holds the equipment names—jet ski, pontoon boat, rowboat, canoe, 
kayak, beach chair, umbrella, and other. Also include a final array that 
includes the surcharges for each equipment type—$50, $40, $15, $12, $10, $2, 
$1, and $0, respectively. Include a constructor that requires an equipment 
type and sets the field to the type unless it is out of range, in which case the 
type is set to the “other” code. Include get and set methods for each field, and 
include an abstract method that returns a String explaining the lesson policy 
for the type of equipment. Save the file as Equipment.java. 


b. Create two classes that extend Equipment—EquipmentWithoutLesson and 
EquipmentWithLesson. The constructor for each class requires that the 
equipment type be in range—that is, jet skis, pontoon boats, rowboats, canoes, 
and kayaks are EquipmentWithLesson objects, but other equipment types are 
not. In both subclasses, the constructors set the equipment type to “other” if it 
is not in range. The constructors also set the equipment fee, as described in part 
2a. Each subclass also includes a method that returns a message indicating 
whether a lesson is required, and the cost ($27) if it is. Save the files as 
EquipmentWithoutLesson.java and Equipment WithLesson.java. 















c. In Chapter 8, you created a Rental class. Now, modify it to contain an 
Equipment data field and an additional price field that holds a base price before 
equipment fees are added. Remove the array of equipment Strings from the 
Rental class as well as the method that returns an equipment string. Modify the 
Rental constructor so that it requires three parameters: contract number, 
minutes for the rental, and an equipment type. The method that sets the hours 
and minutes now sets a base price before equipment fees are included. Within 
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the constructor, set the contract number and time as before, but add statements 
to create either an EquipmentWithLesson object or an EquipmentWithoutLesson 


object, and assign it to the Equipment data field. Assign the sum of the base 


price (based on time) and the equipment fee (based on the type of equipment) 


to the price field. Save the file as Rental.java. 


In Chapter 8, you created a Renta1Demo class that displays details for four Rental 


objects. Modify the class as necessary to use the revised Rental class that 


contains an Equipment field. Be sure to modify the method that displays details 
for the Rental to include all the pertinent data for the equipment. Figure 11-35 


shows the output from a typical execution. Save the file as RentalDemo.java. 









| 
a 


§ Command Prompt 


Contract #A213 

For a rental of 1 hours and @ minutes, 
at a rate of $46 per hour and $1 per extra minute, 
the base price i 


This type of pantal requires a lesson "for $27.8 
The equipment fee with lesson is 77.0 
The total price is 117.0 


For a rental of 2 hours and 5 minutes, 
at a pate of $46 per hour and $1 per extra minute, 
the base price is $85.6 
Contact phone number is: (345) 768-9088 
Equipment rented is type #1 -—- pontoon boat 
This type of rental _requires ay le n for $27.8 
6 


mW 


For a rental of 6 hours and 56 minutes, 
at a vate of $40 per hour and $1 per extra minute, 
the base price is $280.0 

Contact phone number is: (465) 123-9688 

Equipment rented is type #5 -—- beach chair 





This type of rental does not require a lesson. 
Nthe equipment fee with lesson is 2.6 
The total price is 282.6 


ntract #D816 
a vental of 1 hours and 5 minutes, 
at a rate of $46 per hour and $1 per extra minute, 
the base price is $45.6 
Contact phone number is: (812) 876-7667 
Equipment rented is type #6 —- umbrella 


This type of rental does not require a lesson. 
The equipment fee with lesson is 1.8 
The total price is 46.6 











Output of typical RentalDemo execution 


ted, in whole or in 
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Exception Handling 


In this chapter, you will: 


Learn about exceptions 


(©) 


Try code and catch exceptions 


(©) 


Throw and catch multiple exceptions 
Use the final ly block 
Understand the advantages of exception handling 


(ORT OREO) 


Specify the exceptions that a method can throw 


(©) 


Trace exceptions through the call stack 


(©) 


Create your own Exception classes 


(©) 


Use an assertion 


(©) 
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Learning About Exceptions 


An exception is an unexpected or error condition. The programs you write can generate 
many types of potential exceptions: 


e A program might issue a command to read a file from a disk, but the file does not exist there. 
604 





e A program might attempt to write data to a disk, but the disk is full or unformatted. 
e A program might ask for user input, but the user enters an invalid data type. 

e A program might attempt to divide a value by 0. 

e A program might try to access an array with a subscript that is too large or too small. 


These errors are called exceptions because, presumably, they are not usual occurrences; they 
are “exceptional.” Exception handling is the name for the object-oriented techniques that 
manage such errors. Unplanned exceptions that occur during a program’s execution are also 
called runtime exceptions, in contrast with syntax errors that are discovered during program 
compilation. 


Java includes two basic classes of errors: Error and Exception. Both of these classes descend 
from the Throwable class, as shown in Figure 12-1. Like all other classes in Java, Error and 
Exception originally descend from Object. 


java.lang.Object 


+--java.lang.Throwable 

| 

+--java.lang.Exception 
+--java.io.IOException 


+--java.lang.RuntimeException 


+--java.lang.ArithmeticException 


+-- java. lang. IndexOutOfBoundsException 


+--java.lang.ArrayIndexOutOfBoundsException 


+-- java.util .NoSuchElementException 


+--java.util.InputMismatchException 





+--Others.. 








Figure 12-1 The Exception and Error class inheritance hierarchy (continues) 
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(continued) 


+--java.lang.Error 


+-- java.lang.VirtualMachineError 605 


| 








+--java.lang.OutOfMemoryError 


| 


+--java.lang.InternalError 


+--Others... 





Figure 12-1 The Exception and Error class inheritance hierarchy 


The Error class represents more serious errors from which your program usually cannot 
recover. For example, there might be insufficient memory to execute a program. Usually, you 
do not use or implement Error objects in your programs. A program cannot recover from 
Error conditions on its own. 


The Exception class comprises less serious errors representing unusual conditions that arise 
while a program is running and from which the program can recover. Some examples of 
Exception class errors include using an invalid array subscript or performing certain illegal 
arithmetic operations. 


Java displays an Exception message when the program code could have prevented an error. 
For example, Figure 12-2 shows a class named Division that contains a single, small mainO 
method. The method declares three integers, prompts the user for values for two of them, and 
calculates the value of the third integer by dividing the first two values. 


import java.util.Scanner; 
public class Division 
{ 
public static void main(String[] args) 
{ 
Scanner input = new Scanner(System. in); 
int numerator, denominator, result; 
System.out.printC"Enter numerator >> "); 


numerator = input.nextintQ; 
System.out.printC"Enter denominator >> "); 
denominator = input.nextIntQ; 
result = numerator / denominator; 
System.out.printIn(numerator + " / 


+ denominator + 


+ result); 





Figure 12-2 The Division class 
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Figure 12-3 shows two typical executions of the Division program. In the first execution, the 
user enters two usable values and the program executes normally. In the second execution, 
the user enters 0 as the value for the denominator and an Exception message is displayed. 
(Java does not allow integer division by 0, but floating-point division by 0 is allowed—the 
result is displayed as Infinity.) In the second execution in Figure 12-3, most programmers 
would say that the program experienced a crash, meaning that it ended prematurely with an 
error. The term crash probably evolved from the hardware error that occurs when a read/ 
write head abruptly comes into contact with a hard disk, but the term has evolved to include 
software errors that cause program failure. 
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ro 


C:\Java>java Division 
Enter numerator >> 12 
Enter denominator >> 4 
H2 7 4=3 


C:\Java>java Division 

Enter numerator >> 12 

Enter denominator >> @ 

Exception in thread “main” java.lang.frithmeticException: / by zero 
at Division.mainCDivision. java:12> 


C:\Java>_ 








x ——————E—————  SF—mIII7]|§|:_—=|—E J 


Figure 12-3 Two typical executions of the Division application 


In Figure 12-3, the Exception is a java. lang.ArithmeticException. ArithmeticException 
is one of many subclasses of Exception. Java acknowledges more than 75 categories of 
Exceptions with unusual names such as ActivationException, AlreadyBoundException, 
AWTException, CloneNotSupportedException, PropertyVetoException, and 
UnsupportedFlavorException. 


Besides the type of Exception, Figure 12-3 also shows some information about the error 
(“/ by zero”), the method that generated the error (Division.main), and the file and line 
number for the error (Division.java, line 12). 


Figure 12-4 shows two more executions of the Division class. In each execution, the user has 
entered noninteger data for the denominator—first a string of characters, and second, a 
floating-point value. In each case, a different type of Exception occurs. You can see from both 
sets of error messages that the Exception is an InputMismatchException. The last line of the 
messages indicates that the problem occurred in line 11 of the Division program, and the 
second-to-last error message shows that the problem occurred within the call to nextIntQ). 
Because the user did not enter an integer, the nextInt© method failed. The second-to-last 
message also shows that the error occurred in line 2050 of the nextInt() method, but clearly 
you do not want to alter the nextInt© method that resides in the Scanner class—you either 
want to rerun the program and enter an integer, or alter the program so that these errors 
cannot occur in subsequent executions. 
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fay Command Prompt 


C:\Java>java Division 
" numerator >> 12 
* denominator >> three 
Exception in thread “main” java.util.InputMismatchException 
at java.util.Scanner.throwFor<Scanner. java:84@) 
at java.util.Scanner.next (Scanner. java:1461> 607 
at java.util.Scanner.nextInt<¢Scanner. java:2691> 
at java.util.Scanner.nextInt¢Scanner. java:265@> 
at Division.main(Division. java:11> 








C:\Java>java Division 
Enter numerator >> 12 
Enter denominator >> 3.6 
Exception in thread “main” java.util.InputMismatchException 
at java.util.Scanner.throwFor<Scanner. java:84@) 
at java.util.Scanner.next (Scanner. java:1461> 
at java.util.Scanner.nextInt<¢Scanner. java:2691> 
at java.util.Scanner.nextInt¢Scanner. java:265@) 
at Division.main(Division.java:11> 


Bc :\Java> 











Figure 12-4 Two executions of the Division application in which the user entered noninteger 
values 


The list of error messages after each attempted execution in Figure 12-4 is called a stack 
trace history list, or more simply, a stack trace. (You might also hear the terms stack 
backtrace or stack traceback.) The list shows each method that was called as the program ran. 
You will learn more about tracing the stack later in this chapter. 


Just because an exception occurs, you don’t necessarily have to deal with it. In the Division 
class, you can simply let the offending program terminate as it did in Figure 12-4. However, 
the program termination is abrupt and unforgiving. When a program divides two numbers 
(or performs a less trivial task such as balancing a checkbook), the user might be annoyed if 
the program ends abruptly. However, if the program is used for a mission critical task such as 
air-traffic control or to monitor a patient’s vital statistics during surgery, an abrupt conclusion 
could be disastrous. (The term mission critical refers to any process that is crucial to an 
organization.) Object-oriented error-handling techniques provide more elegant and safer 
solutions for errors. 


Of course, you can write programs without using exception-handling techniques—you have 
already written many such programs as you have worked through this book. Programmers 
had to deal with error conditions long before object-oriented methods were conceived. 
Probably the most common error-handling solution has been to use a decision to avoid an 
error. For example, you can change the main() method of the Division class to avoid 
dividing by 0 by adding the decision shown in the shaded portion of Figure 12-5: 
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import java.util.Scanner; 
public class Division2 
{ 
public static void main(String[] args) 
{ 
Scanner input = new Scanner(System.in); 
int numerator, denominator, result; 
System.out.printC"Enter numerator >> "); 
numerator = input.nextintQ; 
System.out.printC"Enter denominator >> "); 
denominator = input.nextIntQ; 


if(denominator == 0) 
System.out.printInC"Cannot divide by 0"); 
else 


fe 


result = numerator / denominator; 
System.out.printIn(numerator + " / " + denominator + 
"= " + result); 


Figure 12-5 The Division2 application using a traditional error-handling technique 


The application in Figure 12-5 displays a message to the user when 0 is entered for a 
denominator value, but it is not able to recover when noninteger data such as a string or 
floating-point value is entered. Object-oriented exception handling provides a more elegant 
solution for handling error conditions. 


Programs that can handle exceptions appropriately are said to be more fault tolerant and 
robust. Fault-tolerant applications are designed so that they continue to operate, possibly at a 
reduced level, when some part of the system fails. Robustness represents the degree to which 
a system is resilient to stress, maintaining correct functioning. 


Even if you choose never to use exception-handling techniques in your own programs, 
you must understand them because built-in Java methods will throw exceptions to your 
programs. 
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Trying Code and Catching Exceptions, 


Learning About Exceptions 


1. Exception handling is the name for the object-oriented techniques used to 609 
manage runtime errors. 








2. The Error class represents serious errors from which your program usually 
cannot recover; the Exception class comprises less serious errors 
representing unusual conditions that occur while a program is running and from 
which the program can recover. 


3. When an exception occurs, your program must handle it using object-oriented 
exception-handling techniques. 


‘asue yey} Suoidaoxa 
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Trying Code and Catching Exceptions 


In object-oriented terminology, you “try” a procedure that might cause an error. A method 
that detects an error condition “throws an exception,” and the block of code that processes 
the error “catches the exception.” 


When you create a segment of code in which something might go wrong, you place the code 
in a try block, which is a block of code you attempt to execute while acknowledging that an 
exception might occur. A try block consists of the following elements: 


e The keyword try 

e An opening curly brace 

e Executable statements, including some that might cause exceptions 
e A closing curly brace 


To handle a thrown exception, you can code one or more catch blocks immediately following 
a try block. A catch block is a segment of code that can handle an exception that might be 
thrown by the try block that precedes it. The exception might be one that is thrown 
automatically, or you might explicitly write a throw statement. A throw statement is one that 
sends an Exception object out of a block or a method so that it can be handled elsewhere. 
A thrown Exception can be caught by a catch block. Each catch block can “catch” one type 
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of exception—that is, one object that is an object of type Exception or one of its child classes. 
You create a catch block by typing the following elements: 
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The keyword catch 

An opening parenthesis 

An Exception type 

A name for an instance of the Exception type 
A closing parenthesis 

An opening curly brace 


The statements that take the action you want to use to handle the error condition 


e A closing curly brace 


Figure 12-6 shows the general format of a method that includes a shaded try..catch pair. 
A catch block looks a lot like a method named catch() that takes an argument that is some 
type of Exception. However, it is not a method; it has no return type, and you can’t call it 
directly. Some programmers refer to a catch block as a catch clause. 


returnType methodName (optional arguments) 


{ 


// optional statements prior to code that is tried 
try 
{ 


is 


catch(Exception someException) 


f 
} 


// optional statements that occur after try, 
// whether or not catch block executes 


// statement or statements that might generate an exception 


// actions to take if exception occurs 





Figure 12-6 Format of try...catch pair 


In Figure 12-6, someException represents an object of the Exception class or any of its 
subclasses. If an exception occurs during the execution of the try block, the statements in the 
catch block execute. If no exception occurs within the try block, the catch block does not 
execute. Either way, the statements following the catch block execute normally. 


Figure 12-7 shows an application named DivisionMistakeCaught that improves on the 
Division class. The main© method in the class contains a try block with code that attempts 
division. When illegal integer division is attempted, an ArithmeticException is automatically 
created and the catch block executes. Figure 12-8 shows two typical executions, one with a 
generated Exception and one without. 
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| import java.util.Scanner; 
public class DivisionMistakeCaught 
{ 
public static void main(String[] args) 
{ 611 
Scanner input = new Scanner(System. in); 
int numerator, denominator, result; 
System.out.printC"Enter numerator >> "); 
numerator = input.nextintQ; 
System.out.printC"Enter denominator >> "); 
denominator = input.nextIntQ; 
try 
{ | 
| 








result = numerator / denominator; 
System.out.printIn(numerator + " / " + denominator + 

"=" + result); 
EE 


catch(ArithmeticException mistake) 


it 
f 


System.out.printInC"Attempt to divide by zero"); 


Figure 12-7 The DivisionMistakeCaught application 





a 
f=" Command Prompt eet 





Cz=\Java>java DivisionMistakeCaught 
Enter numerator >> 26 

Enter denominator >> 5 

2675 =4 


C:\Java>java DivisionMistakeCaught 
a y numerator >> 26 

» denominator >> @ 
Attempt to divide hy zero 


Cz\Java>_ 

















Figure 12-8 Two executions of the DivisionMistakeCaught application 


Jf», ‘nthe application in Figure 12-7, the throw and catch operations reside in the same method. Later in this 
hp chapter, you will learn that throws and their corresponding catch blocks frequently reside in separate 
(7 methods. 


- If you want to send error messages to a location other than “normal” output, you can use System. err 
UY instead of System. out. For example, if an application writes a report to a specific disk file, you might want 


C errors to write to a different location—perhaps to a different disk file or to the screen. 
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Although the DivisionMistakeCaught application displays the error message (“Attempt to 

divide by zero”), you cannot be sure that division by 0 was the source of the error. In reality, 

any ArithmeticException generated within the try block in the program would be caught 

by the catch block in the method. Instead of writing your own message, you can use the 

getMessage() method that ArithmeticException inherits from the Throwable class. To 
612 retrieve Java’s message about any ThrowableException named someException, you code 
someException.getMessage(). 





object using Java’s BigDecimal class and then perform a division that results in a nonterminating decimal 
division such as 1/3 but specify that an exact result is needed, an ArithmeticException is thrown. 
As another example, you could create your own class containing a method that creates a new instance of the 
ArithmeticException class and throws it under any conditions you specify. 


Q As an example of another condition that could generate an ArithmeticException, if you create an 


For example, Figure 12-9 shows a DivisionMistakeCaughtz2 class that uses the getMessage() 
method (see the shaded statement) to generate the message that “comes with” the caught 
ArithmeticException argument to the catch block. Figure 12-10 shows the output; the 
message is “/ by zero”. 


import java.util.Scanner; 
public class DivisionMistakeCaught2 
{ 
public static void main(String[] args) 
{ 
Scanner input = new Scanner(System. in); 
int numerator, denominator, result; 
System.out.printC"Enter numerator >> "); 
numerator = input.nextIintQ; 
System.out.printC"Enter denominator >> "); 
denominator = input.nextIntQ; 
try 
{ 
result = numerator / denominator; 
System.out.print]n(numerator + " / 


= " + result); 


+ denominator + 


F 


catch(ArithmeticException mistake) 


{ 


System.out.printIn(mistake.getMessage()); 





Figure 12-9 The DivisionMistakeCaught2 application 
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ia 
{8 Command Prompt i ee 








|> 


Cz\Java>java DivisionMistakeCaught2 
Enter numerator 22 

Enter denominator >> @ 

/ by zero 


C=\Java> 


613 




















Figure 12-10 Output of the DivisionMistakeCaught2 application 


It should be no surprise that the automatically generated error message in Figure 12-10 is 
“/ by zero”; you saw the same message in Figure 12-3 when the programmer provided no 
exception handling, the exception was automatically thrown, and its message was 
automatically supplied. 


Of course, you might want to do more in a catch block than display an error message; 
after all, Java did that for you without requiring you to write the code to catch any exceptions. 
You also might want to add code to correct the error; for example, such code could force the 
arithmetic to divide by 1 rather than by 0. Figure 12-11 shows try...catch code in which 
the catch block computes the result by dividing by 1 instead of by the denominator value. 
After the catch block, the application could continue with a guarantee that result holds a 
valid value—either the division worked in the try block and the catch block did not execute, 
or the catch block remedied the error. 








try 
{ 
result = numerator / denominator; 
} 
catch(ArithmeticException mistake) 
{ 
result = numerator / 1; 
$ 


// program continues here; result is guaranteed to have a valid value 





Figure 12-11 Atry..catch block in which the catch block corrects the error 


result = numerator; instead of result = numerator / 1;. Explicitly dividing by 1 simply 
makes the code’s intention clearer, but it does require a small amount of time to execute the instruction. 
As an alternative, you could make the program more efficient by omitting the division by 1 and adding 
clarity with a comment. 


Q In the code in Figure 12-11, you can achieve the same result in the catch block by coding 
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Using a try Block to Make Programs “Foolproof” 


One of the most common uses for a try block is to circumvent user data entry errors. When 
testing your own programs throughout this book, you might have entered the wrong data 
type accidentally in response to a prompt. For example, if the user enters a character or 
614 floating-point number in response to a nextInt() method call, the program crashes. Using a 
try block can allow you to handle potential data conversion exceptions caused by careless 
users. You can place conversion attempts, such as calling nextInt© or nextDouble(), in a 
try block and then handle any generated errors. 





In Chapter 2, you learned to add a nextLine() call after any nextQ), nextInt(), or 
nextDouble() call to absorb the Enter key remaining in the input buffer before subsequent 
nextLine() calls. When you attempt to convert numeric data in a try block and the effort is 
followed by another attempted conversion, you also must remember to account for the 
potential remaining characters left in the input buffer. For example, Figure 12-12 shows a 
program that accepts and displays an array of six integers. The shaded and commented line is 
not part of the program when it is executed twice in Figure 12-13. 


import java.util.Scanner; 
public class EnteringIntegers 
{ 
public static void main(String[] args) 
{ 
int{] numberList = {0, 0, 0, 0, 0, 0}; 
int x; 
Scanner input = new Scanner(System. in); 
for(x = 0; x < numberList.length; ++x) 
{ 
try 
{ 
System.out.printC"Enter an integer >> "); 
numberList[x] = input.nextIntQ; 
} 
catch(Exception e) 


{ 


} 
// input.nextLineQ; 


System.out.printInC"Exception occurred") ; 


} 

System.out.print("The numbers are: "); 

for(x = 0; x < numberList.length; ++x) 
System.out.print(numberList[x] + " "); 

System.out.printInQ; 





Figure 12-12 The EnteringIntegers program 
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fH Command Prompt 


iC: weaver daue EnteringIntegers 
Enter > de a 

Enter 
Enter a 
Enter < 
Enter 
Enter 


integer 
integer 


integer 
integer 
integer 
integer 
The numbers are: 


C:\Java>_ 


>> 
>> 
>> 
>> 
>> 
11 


> wu 


>> Exception occurred 
Exception occurred 
Ex 


22 


22 


22 
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33 44 55 66 615 


\Javarjava EnteringIntegers 
> 1 








tion occurred 


6666 

















Figure 12-13 Two typical executions of the EnteringIntegers program without the extra 


nextLineQ© call 


In Figure 12-13, you can see that when a user enters valid data in the first execution, 
the program runs smoothly. However, in the second execution, the user enters some letters 
instead of numbers. The program correctly displays Exception occurred, but the user is 

not allowed to enter data for any of the remaining numbers. The problem can be corrected 
by uncommenting the shaded nextLine() call in the program in Figure 12-12. After the 
program is recompiled, it executes as shown in Figure 12-14. Now, the data entry exception 
is noted, but the user can continue entering data for the remaining array elements. 


Command Prompt 
ics] rompt 


y an integer 
* an integer 
* an integer 


" an integer 
" an integer 
* an integer 


The numbers are: 


C=\Java> 


‘ss 11 
Sarr 


>> 


>> 
>> 
>> 
1 


22 @ 44 55 66 








Figure 12-14 A typical execution of the EnteringIntegers program with the extra 


nextLineQ call 
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Declaring and Initializing Variables in try...catch Blocks 


You can include any legal Java statements within a try block or catch block, including 

declaring variables. However, you must remember that a variable declared within a block is 

local to that block. In other words, the variable goes out of scope when the try or catch block 
616 ends, so any variable declared within one of the blocks should serve only a temporary purpose. 





If you want to use a variable both with a try or catch block and afterward, then you must 

declare the variable before the try block begins. However, if you declare a variable before a 
try block but wait to assign its initial usable value within the try..catch block, you must be 
careful that the variable receives a useful value; otherwise, when you use the variable after the 
try..catch pair ends, the program will not compile. 


Figure 12-15 illustrates this scenario. In the UninitializedVariableTest program, x is 
declared and its value is received from the user in a try block. Because the user might 

not enter an integer, the conversion to an integer might fail, and an exception might be 
thrown. In this example, the catch block only displays a message and does not assign a useful 
value to x. When the program attempts to display x after the catch block, an error message is 
generated, as shown in Figure 12-16. You have three easy options for fixing this error: 


e You can assign a value to x before the try block starts. That way, even if an exception is 
thrown, x will have a usable value to display in the last statement. 


e You can assign a usable value to x within the catch block. That way, if an exception is 
thrown, x will again hold a usable value. 


e You can move the output statement within the try block. If the conversion of the user’s 
entry to an integer is successful, the try block finishes execution and the value of x is 
displayed. However, if the conversion fails, the try block is abandoned, the catch block 
executes, the error message is displayed, and x is not used. 


import java.util.Scanner; 
public class UninitializedVariableTest 
{ 
public static void main(String[] args) 
{ 
int x; 
Scanner input = new Scanner(System. in); 
try 
{ 
System.out.printC"Enter an integer >> "); 
xX = input.nextIntQ; 
} 
catch(Exception e) 


{ 
} 


System.out.printIn("x is 


System.out.printInC"Exception occurred") ; 


+ X)3 





Figure 12-15 The UninitializedVariableTest program 
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fs Command Prompt 


\Java>javac UninitializedVariableTest. Java 
ia initdaliccadUan iableTest.java:17: error: variable x might not have been initial 5 
ized 
System.out.printin¢"x is “ 


1 error 


617 


C2\Java> 














Figure 12-16 The error message generated when compiling the UninitializedVariableTest 
program 


ee 
Su Watch the video Exceptions. 


Trying Code and Catching Exceptions 


1. Atry block is a block of code you attempt to execute while acknowledging that 
an exception might occur. 


2. You usually code at least one catch block immediately following a try block to 
handle an exception that might be thrown by the try block. 


3. A throw statement is one that sends an Exception object to a try block so it 
can be handled. 


"y90|q y2e> B O} 
10a[go uoLydadxq Ue SpUas JUaWAale]s mouyr Y “EH SI JUaWAe]s asje} su] 


aN You Do It 


Throwing and Catching an Exception 


In this section, you create an application in which the user enters two values to be 
divided. The application catches an exception if either of the entered values is not an 
integer. 


(continues) 
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(continued) 


1. Open a new file in your text editor, and type the first few lines of an interactive 
618 application named ExceptionDemo. 





import javax.swing.*; 
public class ExceptionDemo 


{ 
public static void main(String[] args) 


{ 


2. Declare three integers—two to be input by the user and a third to 
hold the result after dividing the first two. The numerator and denominator 
variables must be assigned starting values because their values will be 
entered within a try block. The compiler understands that a try block 
might not complete; that is, it might throw an exception before it is 
through. Also declare an input String to hold the return value of the 
JOptionPane showInputDialog() method. 


int numerator = 0, denominator = 0, result; 
String inputString; 


3. Adda try block that prompts the user for two values, converts each entered 
String to an integer, and divides the values, producing result. 


try 
{ 
inputString = JOptionPane.showInputDialog(null, 
"Enter a number to be divided"); 
numerator = Integer.parseIntCinputString) ; 
inputString = JOptionPane.showInputDialog(null, 
"Enter a number to divide into the first number"); 
denominator = Integer.parseIntCinputString) ; 
result = numerator / denominator; 


} 


4. Add a catch block that catches an ArithmeticException object if division 
by 0 is attempted. If this block executes, display an error message, and force 
result to 0. 


catch(ArithmeticException exception) 

{ 
JOptionPane.showMessageDialog(null, exception. getMessage()); 
result = 0; 


Is 


5. Whether or not the try block succeeds, display the result (which might have 
been set to 0). Include closing curly braces for the main© method and for 


the class. : 
(continues) 
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(continued) 


JOptionPane.showMessageDialog(null, numerator + " / " + 
denominator + "\nResult is " + result); 
} 619 








} 


6. Save the file as ExceptionDemo.java, and then compile and execute the 
application. Enter two nonzero integer values. For example, the first execution in 
Figure 12-17 shows the output when the user enters 12 and 3 as the two input 
values. The application completes successfully. Click OK to end the application, 
and execute the ExceptionDemo application again. This time, enter 0 for the 
second value; the output looks like the second part of Figure 12-17. Click OK to 
end the application. 


Message 


@ 1213 


Result is 4 





Figure 12-17 Output of two executions of the ExceptionDemo application 


Throwing and Catching Multiple Exceptions 


You can place as many statements as you need within a try block, and you can catch as many 
exceptions as you want. If you try more than one statement, only the first error-generating 
statement throws an exception. As soon as the exception occurs, the logic transfers to the 
catch block, which leaves the rest of the statements in the try block unexecuted. 


When a program contains multiple catch blocks, they are examined in sequence until a 
match is found for the type of exception that occurred. Then, the matching catch block 
executes, and each remaining catch block is bypassed. 


For example, consider the application in Figure 12-18. The main() method in the 
DivisionMistakeCaught3 class throws two types of Exception objects: an 
ArithmeticException and an InputMismatchException. The try block in the 
application surrounds all the statements in which the exceptions might occur. 
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import java.util.*; 
public class DivisionMistakeCaught3 
{ 
public static void main(String[] args) 
620 { 





Scanner input = new Scanner(System. in); 
int numerator, denominator, result; 

try 

{ 


System.out.printC"Enter numerator >> "); 
numerator = input.nextInt(Q); 
System.out.printC"Enter denominator >> "); 
denominator = input.nextInt(); 


result = numerator / denominator; 
System.out.print]n(numerator + " / 


= " + result); 


+ denominator + 


} 
catch(ArithmeticException mistake) 


{ 
} 


catch(InputMismatchException mistake) 


if 


System.out.printIn(mistake.getMessage()) ; 


System.out.printInC"Wrong data type"); 





Figure 12-18 The DivisionMistakeCaught3 class 


The program in Figure 12-18 must import the java.util. InputMismatchException class to be able 
to use an InputMismatchException object. The java.util package is also needed for the 
Scanner class, so it’s easiest to import the whole package. 


If you use the getMessage() method with the InputMismatchException object, you see that the 
message is nul1, because nu11 is the default message value for an InputMi smatchException 
object. 


In the main@ method of the program in Figure 12-18, the try block executes. Several 
outcomes are possible: 


e [Ifthe user enters two usable integers, result is calculated, normal output is displayed, 
and neither catch block executes. 


e If the user enters an invalid (noninteger) value at either the first or second shaded 
statement, an InputMismatchException object is created and thrown. When the program 
encounters the first catch block (that catches an ArithmeticException), the block is 
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bypassed because the Exception types do not match. When the program encounters the 
second catch block, the types match, and the “Wrong data type” message is displayed. 


e Ifthe user enters 0 for denominator, the division statement throws an 
ArithmeticException, and the try block is abandoned. When the program encounters 
the first catch block, the Exception types match, the value of the getMessage() method 


is displayed, and then the second catch block is bypassed. ner 








Figure 12-19 shows the output of four typical program executions. 





* numerator >> 
* denominator >> 5 
5 ? 


C:\Java>java DivisionMistakeCaught3 
J y numerator >> 6 

* denominator >> two 
Wrong data type 


C:\Java>java DivisionMistakeCaught3 
* numerator >> 13 
» denominator >> @ 

















Figure 12-19 Four executions of the DivisionMistakeCaught3 application 


When you list multiple catch blocks following a try block, you must be careful that 

some catch blocks don’t become unreachable. Unreachable statements are program 
statements that can never execute under any circumstances. For example, if two successive 
catch blocks catch an ArithmeticException and an ordinary Exception, respectively, the 
ArithmeticException errors cause the first catch to execute and other types that 

derive from Exception “fall through” to the more general Exception catch block. However, 
if you reverse the sequence of the catch blocks so the one that catches general Exception 
objects is first, even ArithmeticExceptions would be caught by the Exception catch. 

The ArithmeticException catch block therefore is unreachable because the Exception 
catch block is in its way, and the class does not compile. Think of arranging your catch 
blocks so that the “bigger basket” is always below a smaller one. That is, each Exception 
should “fall through” as many catch blocks as necessary to reach the one that will hold it. 


You first learned about unreachable statements in Chapter 3. For example, statements that follow a method's 
return statement are unreachable. Creating an unreachable catch block causes a compiler error that 
generates a message indicating that the exception “has already been caught.” 
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Sometimes, you want to execute the same code no matter which Exception type occurs. For 
example, within the DivisionMistakeCaught3 application in Figure 12-18, each of the two 
catch blocks displays a unique message. Instead, you might want both catch blocks to display 
the same message. Because ArithmeticExceptions and InputMismatchExceptions are both 
subclasses of Exception, you can rewrite the program as shown in Figure 12-20, using a single 
622 generic catch block (shaded) that can catch any type of Exception object. 





import java.util.*; 
public class DivisionMistakeCaught4 
{ 
public static void main(String[] args) 
{ 
Scanner input = new Scanner(System. in); 
int numerator, denominator, result; 
try 
{ 
System.out.printC"Enter numerator >> "); 
numerator = input.nextIntQ; 
System.out.printC"Enter denominator >> "); 
denominator = input.nextIntQ); 
result = numerator / denominator; 
System.out.print]n(numerator + " / 


= " + result); 


+ denominator + 


} 
catch(Exception mistake) 


a 


System.out.printInC"Operation unsuccessful") ; 





Figure 12-20 The DivisionMistakeCaught4 application 


The catch block in Figure 12-20 accepts a more generic Exception argument type than that 
thrown by either of the potentially error-causing try statements, so the generic catch block 
can act as a “catch-all” block. When either an arithmetic error or incorrect input type error 
occurs, the thrown exception is “promoted” to an Exception error in the catch block. Figure 
12-21 shows several executions of the DivisionMistakeCaught4 application. Notice that no 
matter which type of mistake occurs during execution, the general “Operation unsuccessful” 
message is displayed by the generic catch block. 
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rn 
fxs Command Prompt a 


C:\Java>java DivisionMistakeCaught4 
Enter numerator >> 12 

Enter denominator >> six 

Operation unsuccessful 





C=:\Java>java DivisionMistakeCaught4 
Enter numerator >> 12.6 623 
sOperation unsuccessful 








C:\Java>java DivisionMistakeCaught4 


Enter numerator 
Enter denominator >> @ 
Operation unsuccessful 














Figure 12-21 Several executions of the DivisionMistakeCaught4 application 


As a new feature in Java 7, a catch block can also be written to catch specific multiple 
exception types. For example, the following catch block catches two Exception types. When 
either is caught, its local identifier is e. 


catch(ArithmeticException, InputMismatchException e) 


{ 
} 


Although a method can throw any number of Exception types, many developers believe that 
it is poor style for a method to throw and catch more than three or four types. If it does, one 
of the following conditions might be true: 


e Perhaps the method is trying to accomplish too many diverse tasks and should be broken 
up into smaller methods. 


e Perhaps the Exception types thrown are too specific and should be generalized, as they 
are in the DivisionMistakeCaught4 application in Figure 12-20. 


ee 
=" Watch the video Catching Multiple Exceptions. 
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Throwing and Catching Multiple Exceptions 


624 1. When multiple try block statements throw exceptions, multiple catch blocks 
might execute. 





2. As soonas an exception occurs, the try block that contains it is abandoned and 
the rest of its statements are unexecuted. 


3. When a program contains multiple catch blocks, the first one that matches the 
thrown Exception type is the one that executes. 
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Using Multiple catch Blocks 
In this section, you add a second catch block to the ExceptionDemo application. 
1. Open the ExceptionDemo.java file. Change the class name to 
ExceptionDemo2, and save the file as ExceptionDemo2.java. 


2. Execute the program, and enter a noninteger value at one of the prompts. 
Program execution fails. For example, Figure 12-22 shows the error generated 
when the user types the string “four hundred and seventeen” at the first prompt. 


fH Command Prompt 
ai 


C:\Java>java Except ionDemo2 
Exception in thread “main” jayva.lang.NumberFormatException: For input string: “f 
our hundred and seventeen" 

at java.lang.NumberFormatException.forlInputString<NumberFormatException. 
java:65> 

at java.lang.Integer.parseInt<Integer. java:492> 

at java.lang.Integer.parseInt¢Integer. java:527> 

at Except ionDemo2 .main¢Except ionDemo2. jaya:12> 


= 


Figure 12-22 Error message generated by the current version of the 
ExceptionDemo2 application when a user enters a noninteger value 








(continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce: ight to remove additional content at any time if subsequent rights restrictions require it. 





(continued) 


3. After the existing catch block that catches an ArithmeticException object, 
add a catch block that catches a NumberFormatException object if neither 
user entry can be converted to an integer. If this block executes, display an 625 
error message, Set numerator and denominator to a default value of 999, 
and force result to l. 








catch(NumberFormatException exception) 
{ 
JOptionPane. showMessageDialog(null, 
"This application accepts digits only!"); 
numerator = 999; 
denominator = 999; 
result =1; 


BS 


4. Save, compile, and execute the program. This time, if you enter a noninteger 
value, the output appears as shown in Figure 12-23. Click OK to end the 
application. 


Message , 





@ This application accepts digits only! 





Figure 12-23 Error message generated by the improved version of the 
ExceptionDemo2 application when a user enters a noninteger value 


5. Execute the application a few more times by entering a variety of valid and 
invalid data. Confirm that the program works appropriately whether you type 
two usable integers, an unusable 0 for the second integer, or noninteger data 
such as strings containing alphabetic characters or punctuation. 


Using the finally Block 


When you have actions you must perform at the end of a try..catch sequence, you can use a 
finally block. The code within a finally block executes regardless of whether the 
preceding try block identifies an exception. Usually, you use a finally block to perform 
cleanup tasks that must happen whether or not any exceptions occurred, and whether or not 
any exceptions that occurred were caught. Figure 12-24 shows the format of a try..catch 
sequence that uses a finally block. 
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CHAPTER 12 Exception Handling 


try 
{ 


} 
626 catch(Exception e) 
{ 


} 
finally 
{ 


} 


// statements to try 





// actions that occur if exception was thrown 


// actions that occur whether catch block executed or not 





Figure 12-24 Format of try...catch...final ly sequence 


Compare Figure 12-24 to Figure 12-6 shown earlier in this chapter. When the try code works 
without error in Figure 12-6, control passes to the statements at the end of the method. Also, 
when the try code fails and throws an exception, and the Exception object is caught, the 
catch block executes, and control again passes to the statements at the end of the method. At 
first glance, it seems as though the statements at the end of the method in Figure 12-6 always 
execute. However, the final set of statements might never execute for at least two reasons: 


e Any try block might throw an Exception object for which you did not provide a catch 
block. After all, exceptions occur all the time without your handling them, as one did in 
the first Division application in Figure 12-2 earlier in this chapter. In the case of an 
unhandled exception, program execution stops immediately, the exception is sent to the 
operating system for handling, and the current method is abandoned. 


e The try or catch block might contain a System.exitQ; statement, which stops 
execution immediately. 


When you include a finally block, you are assured that the finally statements will execute 
before the method is abandoned, even if the method concludes prematurely. For example, 
programmers often use a finally block when the program uses data files that must be closed. 
You will learn more about writing to and reading from data files in the next chapter. For now, 
however, consider the format shown in Figure 12-25, which represents part of the logic for a 
typical file-handling program: 
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// Open the file 
// Read the file 
// Place the file data in an array 627 
// Calculate an average from the data 
// Display the average 








} 

catch(IOException e) 

{ 
// Issue an error message 
// System exit 

} 

finally 

{ 


} 


// If the file is open, close it 





Figure 12-25 Pseudocode that tries reading a file and handles an IOException 


The pseudocode in Figure 12-25 represents an application that opens a file; in Java, if a file 
does not exist when you open it, an input/output exception, or IOException, is thrown and a 
catch block can handle the error. However, because the application in Figure 12-25 uses an 
array, an uncaught IndexOutOfBoundsException might occur even though the file opened 
successfully. (An IndexOutOfBoundsException occurs, as its name implies, when a subscript 
is not in the range of valid subscripts for an array.) The IndexOutOfBoundsException would 
not be caught by the existing catch block. Also, because the application calculates an average, 
it might divide by 0 and an ArithmeticException might occur; it also would not be caught. 
In any of these events, you might want to close the file before proceeding. By using the 
finally block, you ensure that the file is closed because the code in the finally block 
executes before control returns to the operating system. The code in the finally block 
executes no matter which of the following outcomes of the try block occurs: 


e The try ends normally. 
e The catch executes. 


e An uncaught exception causes the method to abandon prematurely. An uncaught 
exception does not allow the try block to finish, nor does it cause the catch block to 
execute. 


If an application might throw several types of exceptions, you can try some code, catch the 
possible exception, try some more code and catch the possible exception, and so on. Usually, 
however, the superior approach is to try all the statements that might throw exceptions, and 
then include all the needed catch blocks and an optional finally block. This is the approach 
shown in Figure 12-25, and it usually results in logic that is easier to follow. 
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You can avoid using a finally block, but you would need repetitious code. For example, 
instead of using the finally block in the pseudocode in Figure 12-25, you could insert the 
statement “If the file is open, close it” as both the last statement in the try block and the 
second-to-last statement in the catch block, just before System exit. However, writing code 
just once in a finally block is clearer and less prone to error. 

628 





If a try block calls the System.exit( method and the finally block calls the same method, the 
exitQ method in the finally block executes. The try block’s exit) method call is abandoned. 


C# and Visual Basic contain the keywords try, catch, and finally. 


Q C++ programmers are familiar with try and catch blocks, but C++ does not provide a finally block. 


Using the finally Block 


1. The code within a finally block executes when a try block identifies an 
exception that is not caught. 


2. Usually, you use a finally block to perform cleanup tasks that must happen 
whether or not any exceptions occurred, and whether or not any exceptions that 
occurred were caught. 


3. It’s possible that the code that follows a try...catch...finally sequence might 
never execute—for example, if a try block throws an unhandled exception. 
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Understanding the Advantages of Exception Handling 


Before the inception of object-oriented programming languages, potential program errors 
were handled using somewhat confusing, error-prone methods. For example, a traditional, 
non-object-oriented procedural program might perform three methods that depend on each 
other using code that provides error checking similar to the pseudocode in Figure 12-26. 
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call methodAQ) 

if methodA() worked 

{ 
call methodBQ 629 
if methodB() worked 
{ 








call methodCQ) 
if methodCQ worked 


everything’s okay, so display finalResult 
else 
set errorCode to 'C' 


} 
else 
set errorCode to 'B' 
} 
else 
set errorCode to 'A' 





Figure 12-26 Pseudocode representing traditional error checking 


The pseudocode in Figure 12-26 represents an application in which the logic must pass 
three tests before finalResult can be displayed. The program executes methodA(); it then 
calls methodBQ only if methodAQ) is successful. Similarly, methodC() executes only when 
methodA() and methodB() are both successful. When any method fails, the program sets an 
appropriate errorCode to ‘A’, ‘B’, or ‘C’. (Presumably, the errorCode is used later in the 
application.) The logic is difficult to follow, and the application’s purpose and intended 
usual outcome—to display finalResult—is lost in the maze of if statements. Also, you can 
easily make coding mistakes within such a program because of the complicated nesting, 
indenting, and opening and closing of curly braces. 


Compare the same program logic using Java’s object-oriented, error-handling technique 
shown in Figure 12-27. Using the try..catch object-oriented technique provides the same 
results as the traditional method, but the statements of the program that do the “real” work 
(calling methods A, B, and C and displaying finalResult) are placed together, where their 
logic is easy to follow. The try steps should usually work without generating errors; after all, 
the errors are “exceptions.” It is convenient to see these business-as-usual steps in one 
location. The unusual, exceptional events are grouped and moved out of the way of the 
primary action. 
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call methodAQ) and maybe throw an exception 
call methodBQ) and maybe throw an exception 
630 call methodC(Q) and maybe throw an exception 
everything’s okay, so display finalResult 





} 
catch(methodA()’s error) 


{ 


} 
catch(methodB()’s error) 


{ 
} 
catch(methodC()’s error) 
{ 


} 


set errorCode to "A" 


set errorCode to "B" 


set errorCode to "C" 





Figure 12-27 Pseudocode representing object-oriented exception handling 


Besides clarity, an advantage to object-oriented exception handling is the flexibility it allows in 
the handling of error situations. When a method you write throws an exception, the same 
method can catch the exception, although it is not required to do so, and in most object- 
oriented programs it does not. Often, you don’t want a method to handle its own exception. 
In many cases, you want the method to check for errors, but you do not want to require a 
method to handle an error if it finds one. Another advantage to object-oriented exception 
handling is that you gain the ability to appropriately deal with exceptions as you decide how 
to handle them. When you write a method, it can call another, catch a thrown exception, and 
you can decide what you want to do. Just as a police officer has leeway to deal with a speeding 
driver differently depending on circumstances, programs can react to exceptions specifically 
for their current purposes. 


Methods are flexible partly because they are reusable—that is, a well-written method might 
be used by any number of applications. Each calling application might need to handle a 
thrown error differently, depending on its purpose. For example, an application that uses a 
method that divides values might need to terminate if division by 0 occurs. A different 
program simply might want the user to reenter the data to be used, and a third program 
might want to force division by 1. The method that contains the division statement can throw 
the error, but each calling program can assume responsibility for handling the error detected 
by the method in an appropriate way. 
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Understanding the Advantages of Exception Handling 


1. An advantage to using object-oriented error-handling techniques is that 631 
programs are clearer and more flexible. 








2. An advantage to using object-oriented error-handling techniques is that when a 
method throws an exception, it will always be handled in the same, consistent way. 


3. In many cases, you want a method to check for errors, but you do not want to 
require the method to handle an error if it finds one. 
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Specifying the Exceptions That a Method Can Throw 


If a method throws an exception that it will not catch but will be caught by a different 
method, you must use the keyword throws followed by an Exception type in the method 
header. This practice is known as exception specification. 


For example, Figure 12-28 shows a PriceList class used by a company to hold a list of prices 
for items it sells. For simplicity, there are only four prices and a single method that displays 
the price of a single item. The displayPrice() method accepts a parameter to use as the 
array subscript, but because the subscript could be out of bounds, the method contains a 
shaded throws clause, acknowledging it could throw an exception. 


public class PriceList 


{ 
private static final double[] price = {15.99, 27.88, 34.56, 45.89}; 
public static void displayPrice(int item) throws IndexOutOfBoundsException 


{ 
} 


System.out.printInC"The price is $" + price[item]); 





Figure 12-28 The PriceList class 
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Figures 12-29 and 12-30 show two applications in which programmers have chosen to handle 
the potential exception differently. In the first class, PriceListApplication1, the 
programmer has chosen to handle the exception in the shaded catch block by displaying a 
price of $0. In the second class, PriceListApplication2, the programmer has chosen to 
handle the exception by using the highest price in the array. Figure 12-31 shows several 
632 executions of each program. Other programmers writing other applications that use the 
PriceList class could choose still different actions, but they all can use the flexible 
displayPrice() method because it doesn’t limit the calling method’s choice of recourse. 





import java.util.*; 
public class PriceListApplication1 
{ 
public static void main(String[] args) 
{ 
int item; 
Scanner input = new Scanner(System. in); 
System.out.printC"Enter item number >> "); 
item = input.nextIntQ; 
try 
{ 


} 
catch(IndexOutOfBoundsException e) 


{ 


PriceList.displayPriceCitem) ; 


System.out.printIn("Price is $0"); 





Figure 12-29 The PriceListApplication1 class 
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import java.util.*; 
public class PriceListApplication2 
{ 
public static void main(String[] args) 
{ 633 
int item; 
Scanner input = new Scanner(System. in); 
final int MAXITEM = 3; 
System.out.printC"Enter item number >> "); 
item = input.nextIntQ; 
try 
{ 


} 
catch(IndexOutOfBoundsException e) 
i 


E 








PriceList.displayPriceCitem) ; 


PriceList.displayPrice(MAXITEM) ; 


Figure 12-30 The PriceListApplication2 class 





rn 
fH Command Prompt Sox | 


C2\Java>java PriceListApplicationi 
Enter item number 1 
The price is $27.88 


C:\Java>java PriceListApplicationi1 
Enter item number >> 4 
Price is $@ 


C:\Java>java PriceListApplicat ion2 

Enter item number >> 1 

The price is $27.88 

C:\Java>java PriceListApplicat ion2 
ter item number >> 4 

The price is $45.89 


C=\Java> 

















Figure 12-31 Several executions of PriceListApplication1 and 
PriceListApplication2 









Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning ves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 12 Exception Handling 


For most Java methods that you write, you do not use a throws clause. For example, you have 

not needed to use a throws clause in any of the many programs you have written while 

working through this book; however, in those methods, if you divided by 0 or went beyond an 

array’s bounds, an exception was thrown nevertheless. Most of the time, you let Java handle 

any exception by shutting down the program. Imagine how unwieldy your programs would 

634 become if you were required to provide instructions for handling every possible error, 
including equipment failures and memory problems. Most exceptions never have to be 
explicitly thrown or caught, nor do you have to include a throws clause in the headers of 
methods that automatically throw these exceptions. The only exceptions that must be caught 
or named in a throws clause are the type known as checked exceptions. 





Java’s exceptions can be categorized into two types: 


e Unchecked exceptions—These exceptions inherit from the Error class or the 
RuntimeException class. Although you can handle these exceptions in your 
programs, you are not required to do so. For example, dividing by zero is a type of 
RuntimeException, and you are not required to handle this exception—you can simply 
let the program terminate. 


e Checked exceptions—These exceptions are the type that programmers should anticipate 
and from which programs should be able to recover. All exceptions that you explicitly 
throw and that descend from the Exception class are checked exceptions. 


Java programmers say that checked exceptions are subject to the catch or specify 
requirement, which means if you throw a checked exception from a method, you must 
do one of the following: 


e Catch it within the method. 
e Specify the exception in your method header’s throws clause. 


Code that uses a checked exception will not compile if the catch or specify rule is not 
followed. 


If you write a method with a throws clause in the header, then any method that uses your 
method must do one of the following: 


e Catch and handle the possible exception. 


e Declare the exception in its throws clause. The called method can then rethrow the 
exception to yet another method that might either catch it or throw it yet again. 


In other words, when an exception is a checked exception, client programmers are forced to 
deal with the possibility that an exception will be thrown. 


a term coined by Peter J. Landin to describe aspects of a computer language that make it “sweeter,” or 
easier, for programmers to use. For example, you learned in Chapter 1 that you do not have to write 
import java.lang; atthe top of every Java program file because the package is automatically imported 
for you. The metaphor has been extended by the term syntactic salt, which is a language feature designed 
to make it harder to write bad code. 


Q Some programmers feel that using checked exceptions is an example of “syntactic salt.” Syntactic sugar is 
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If you write a method that explicitly throws a checked exception that is not caught within 
the method, Java requires that you use the throws clause in the header of the method. Using 
the throws clause does not mean that the method will throw an exception—everything might 
go smoothly. Instead, it means the method might throw an exception. You include the 
throws clause in the method header so applications that use your methods are notified of the 
potential for an exception. 635 








number, types, and order of arguments. Some programmers argue that any throws clause is also part 
of the signature, but most authorities disagree. You cannot create a class that contains multiple methods 
that differ only in their return types; such methods are not overloaded. The same is true for methods with 
the same signatures that differ only in their throws clauses; the compiler considers the methods to have an 
identical signature. Instead of saying that the throws clause is part of the method's signature, you might 
prefer to say that it is part of the method's interface. 


Q In Chapter 3, you learned that a method's signature is the combination of the method name and the 


subclass of its parent’s thrown type. These rules do not apply to overloaded methods. Any exceptions may 
(or may not) be thrown from one version of an overloaded method without considering what exceptions are 
thrown by other versions of an overloaded method. 


Q A method that overrides another cannot throw an exception unless it throws the same type as its parent or a 


To be able to use a method to its full potential, you must know the method’s name and three 
additional pieces of information: 


e The method’s return type 
e The type and number of arguments the method requires 
e The type and number of exceptions the method throws 


To use a method, you must know what types of arguments are required. You can call a 
method without knowing its return type, but if you do, you can’t benefit from any value 
that the method returns. (Also, if you use a method without knowing its return type, you 
probably don’t understand the purpose of the method.) Likewise, you can’t make sound 
decisions about what to do in case of an error if you don’t know what types of exceptions 
a method might throw. 


When a method might throw more than one exception type, you can specify a list of 
potential exceptions in the method header by separating them with commas. As an 
alternative, if all the exceptions descend from the same parent, you can specify the 

more general parent class. For example, if your method might throw either an 
ArithmeticException or an ArrayIndexOutOfBoundsException, you can just specify that 
your method throws a RuntimeException. One advantage to this technique is that when your 
method is modified to include more specific RuntimeExceptions in the future, the method 
header will not change. This saves time and money for users of your methods, who will 

not have to modify their own methods to accommodate new RuntimeException types. 


An extreme alternative is simply to specify that your method throws a general Exception 
object, so that all exceptions are included in one clause. Doing this simplifies the exception 
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specification you write. However, using this technique disguises information about the 
specific types of exceptions that might occur, and such information usually has value to 
users of your methods. 


program, and they can be numerous. Programs would be less clear and more cumbersome if you had to 
account for runtime exceptions in every method declaration. Therefore, the Java compiler does not require 
that you catch or specify runtime exceptions. 


Usually, you declare only checked exceptions. Remember that runtime exceptions can occur anywhere in a 
636 GY 





ee a 
=f Watch the video Specifying Exceptions. 


Specifying the Exceptions That a Method Can Throw 


1. Exception specification is the practice of listing possible exceptions in a throws 
clause in a method header. 


2. Many exceptions never have to be explicitly thrown or caught, nor do you have to 
include a throws Clause in the headers of methods that automatically throw 
these exceptions. 


3. If you write a method with a throws clause for a checked exception in the 
header, then any method that uses your method must catch and handle the 
possible exception. 
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Tracing Exceptions Through the Call Stack 


When one method calls another, the computer’s operating system must keep track of 
where the method call came from, and program control must return to the calling method 
when the called method is completed. For example, if methodA(Q) calls methodBQ), the 
operating system has to “remember” to return to methodA() when methodB() ends. Likewise, 
if methodB() calls methodC(), the computer must “remember” while methodC() executes 

to return to methodB() and eventually to methodA(). The memory location known as the 
call stack is where the computer stores the list of method locations to which the system 
must return. 
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When a method throws an exception and the method does not catch it, the exception 

is thrown to the next method up the call stack, or in other words, to the method that called 
the offending method. Figure 12-32 shows how the call stack works. If methodAQ) calls 
methodB(), and methodB() calls methodC(), and methodC() throws an exception, Java 

first looks for a catch block in methodCQ. If none exists, Java looks for the same thing in 
methodB(). If methodB() does not have a catch block, Java looks to methodA(). If methodAQ) 637 
cannot catch the exception, it is thrown to the Java Virtual Machine, which displays a 

message at the command prompt. 








Operating system = |-<_________ 


methodA( ) 
calls methodB( ) 





Can it be caught here? No? — 





Y 


methodB 
calls Friedel ) Can it be caught here? No? — 














Y 


methodC( ) 
throws exception 


' 


Can it be caught here? No? 














Figure 12-32 Cycling through the call stack 


For example, examine the application in Figure 12-33. The main() method of the application 
calls methodA(), which displays a message and calls methodB(). Within methodB(), another 
message is displayed and methodC() is called. In methodCQ), yet another message is displayed. 
Then, a three-integer array is declared, and the program attempts to display the fourth 
element in the array. This program compiles correctly—no error is detected until methodCQ 
attempts to access the out-of-range array element. In Figure 12-33, the comments indicate 
line numbers so you can more easily follow the sequence of generated error messages. You 
probably would not add such comments to a working application. Figure 12-34 shows the 
output when the application executes. 
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public class DemoStackTrace 





{ 
public static void main(String[] args) 
{ 
638 methodAQ); // line 5 

} 

public static void methodAQ 

{ 
System.out.printInC"In methodAQ"); 
methodB(); // line 10 

} 

public static void methodBQ) 

{ 
System.out.printInC"In methodBQ"); 
methodC(Q); // line 15 

} 

public static void methodCQ) 

{ 
System.out.printInC"In methodCQ"); : 
une: [) -abray S105 ba ets Cee 
System.out.printIn(array[3]); // line 21 use an outofrange subscript 

} } in a professional program. 





Figure 12-33 The DemoStackTrace class 





rn = = "| 
fy Command promt St x=) 


C:\Java>java DemoStackTrace 

In methodA<> 

In methodBC> 

In methodC<¢> 

Exception in thread “main” java. lang.fArrayIndexOutOf BoundsExcept ion: 
DemoStackTrace .methodC(Demo$TackTrace. java:21> 

t DemoStackTrace .methodBCDemoSTackTrace.java:15) 

DemoStackTrace .methodA<DemoSTackTrace . java:1@> 
DemoStackTrace.main¢DemoSTackTrace.java:5> 

















Figure 12-34 Error messages generated by the DemoStackTrace application 


As you can see in Figure 12-34, three messages are displayed, indicating that methodAQ, 
methodB(), and methodC() were called in order. However, when methodC() attempts to 
access the out-of-range element in the array, an ArrayIndexOutOfBoundsException is 
automatically thrown. The error message generated shows that the exception occurred at line 
21 of the file in methodC(Q), which was called in line 15 of the file by methodB(), which was 
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Tracing Exceptions Through the Call Stack D0 


called in line 10 of the file by methodAQ), which was called by the main() method in line 5 of 
the file. Using this list of error messages, you could track down the location where the error 
was generated. Of course, in a larger application that contains thousands of lines of code, the 
stack trace history list would be even more useful. 


The technique of cycling through the methods in the stack has great advantages because 
it allows methods to handle exceptions wherever the programmer has decided it is most 
appropriate—including allowing the operating system to handle the error. However, when 
a program uses several classes, the disadvantage is that the programmer finds it difficult to 
locate the original source of an exception. 


639 








You have already used the Throwable method getMessage() to obtain information about an 
Exception object. Another useful Exception method is the printStackTrace() method. When 
you catch an Exception object, you can call printStackTrace() to display a list of methods in 
the call stack and determine the location of the statement that caused the exception. 


For example, Figure 12-35 shows a DemoStackTrace2 application in which the 
printStackTrace() method produces a trace of the trail taken by a thrown exception. 
The differences in the executable statements from the DemoStackTrace application are 
shaded. The call to methodB() has been placed in a try block so that the exception can be 
caught. Instead of throwing the exception to the operating system, this application catches 
the exception, displays a stack trace history list, and continues to execute. The output of 
the list of methods in Figure 12-36 is similar to the one shown in Figure 12-34, but the 
application does not end abruptly. 


public class DemoStackTrace2 


{ 
public static void main(String[] args) 


{ 


} 
public static void methodAQ 


{ 


methodAQ); // line 5 


System.out.printInC"In methodAQ"); 
try 


methodBQ); // line 12 
} 


catch(ArrayIndexOutOfBoundsException error) 


{ 


System.out.printIn("In methodA(Q) - The stack trace:"); 
error.printStackTrace() ; 


} 
System.out.printInC"methodAQ ends normally."); 


System.out.printInC"Application could continue " + 
"from this point."); 





Figure 12-35 The DemoStackTrace2 class (continues) 
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(continued) 


public static void methodBQ) 





{ 
System.out.printInC"In methodBQ"); 
640 methodC(Q); // line 26 
} 
public static void methodCQ) 
{ 
System.out.printInC"In methodCQ"); 
int{] array = {0, 1, 2}; 
System.out.printIn(array[3]); // line 32 
} 


} 
| 


Figure 12-35 The DemoStackTrace2 class 


ni 


C:\Java>java DemoStackTrace2 

In methodAC> 

In methodBC> 

In methodCc¢> 

In methodAC> — The stack trace: 

java.lang.frrayIndexOutOfBoundsException: 3 
at DemoStackTrace2.methodC<DemoStackTrace2. java 
at DemoStackTrace2.methodBCDemoStackTrace2. java: 
at DemoStackTrace2.methodA<CDemoStackTrace2. java 
at DemoStackTrace2.main¢CDemoStackTrace2.java:5)> 

methodAC> ends normally. 

Application could continue from this point. 











SERSELE YS 








Figure 12-36 Output of the DemoStackTrace2 application 


Usually, you do not want to place a printStackTrace() method call in a finished program. 
The typical application user has no interest in the cryptic messages that are displayed. 
However, while you are developing an application, printStackTrace() can be a useful tool 
for diagnosing your class’s problems. 
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Tracing Exceptions Through the Call Stack 


1. The memory location known as the call stack is where the computer stores 641 
the list of locations to which the system must return after each method call. 








2. When a method throws an exception and the method does not catch it, the 
exception is thrown to the next method down the call stack, or in other words, 
to the next method that the offending method calls. 


3. When you catch an exception, you can call printStackTrace() to display a list 
of methods in the call stack and determine the location of the statement that 
caused the exception. However, usually you do not want to place a 
printStackTrace() method call in a finished program. 
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Creating Your Own Exception Classes 


Java provides over 40 categories of Exceptions that you can use in your programs. 
However, Java’s creators could not predict every condition that might be an exception in 
your applications. For example, you might want to declare an Exception when your bank 
balance is negative or when an outside party attempts to access your e-mail account. Most 
organizations have specific rules for exceptional data; for example, an employee number 
must not exceed three digits, or an hourly salary must not be less than the legal minimum 
wage. Of course, you can handle these potential error situations with if statements, but 
Java also allows you to create your own Exception classes. 


To create your own throwable Exception class, you must extend a subclass of 

Throwable. Recall from Figure 12-1 that Throwable has two subclasses, Exception and Error, 
which are used to distinguish between recoverable and nonrecoverable errors. Because 

you always want to create your own exceptions for recoverable errors, your classes should 
extend the Exception class. You can extend any existing Exception subclass, such as 
ArithmeticException or Nul1PointerException, but usually you want to inherit 

directly from Exception. When you create an Exception subclass, it’s conventional to 

end the name with Exception. 


The Exception class contains four constructors as follows: 
e Exception()—Constructs a new Exception object with nu11 as its detail message 


e Exception(String message)—Constructs a new Exception object with the specified 
detail message 
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e Exception(String message, Throwable cause)—Constructs a new Exception object 
with the specified detail message and cause 


e Exception(Throwable cause)—Constructs a new Exception object with the specified 
cause and a detail message of cause. toString(), which typically contains the class and 


642 the detail message of cause, or nu11 if the cause argument is nu11 





For example, Figure 12-37 shows a HighBalanceException class. Its constructor contains a 
single statement that passes a description of an error to the parent Exception constructor. 
This String would be retrieved if you called the getMessage() method with a 
HighBalanceException object. 


public class HighBalanceException extends Exception 


1 


public HighBalanceException() 


{ 
} 


super("Customer balance is high"); 





Figure 12-37 The HighBalanceException class 


Figure 12-38 shows a CustomerAccount class that uses a HighBalanceException. The 
CustomerAccount constructor header indicates that it might throw a HighBalanceException 
(see the first shaded statement); if the balance used as an argument to the constructor exceeds 
a set limit, a new, unnamed instance of the HighBalanceException class is thrown (see the 
second shaded statement). 


public class CustomerAccount 
{ 
private int acctNum; 
private double balance; 
public static double HIGH_CREDIT_LIMIT = 20000.00; 
public CustomerAccount(int num, double bal) throws HighBalanceException 


{ 


acctNum = num; 

balance = bal; 

if(balance > HIGH_CREDIT_LIMIT) 
throwCnew HighBalanceExceptionQ); 





Figure 12-38 The CustomerAccount class 
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HighBalanceException and throw it when the balance exceeds the credit limit. By waiting and 


In the CustomerAccount class in Figure 12-38, you could choose to instantiate a named 
Y instantiating an unnamed object only when it is needed, you improve program performance. 


Figure 12-39 shows an application that instantiates a CustomerAccount. In this application, a 
user is prompted for an account number and balance. After the values are entered, an attempt 
is made to construct a CustomerAccount in a try block (as shown in the first shaded section). 
If the attempt is successful—that is, if the CustomerAccount constructor does not throw an 
Exception—the CustomerAccount information is displayed in a dialog box. However, if the 
CustomerAccount constructor does throw a HighBalanceException, the catch block receives 
it (as shown in the second shaded section) and displays a message. A different application 
could take any number of different actions; for example, it could display the return 

value of the getMessage() method, construct a CustomerAccount object with a lower 
balance, or construct a different type of object—perhaps a child of CustomerAccount 

called PreferredCustomerAccount that allows a higher balance. Figure 12-40 shows typical 
output of the application in a case in which a customer’s balance is too high. 


643 








import javax.swing.*; 
public class UseCustomerAccount 
{ 
public static void main(String[] args) 
{ 
int num; 
double balance; 
String input; 
input = JOptionPane.showInputDialog(null, 
"Enter account number"); 
num = Integer.parseInt(input) ; 
input = JOptionPane.showInputDialog(null, "Enter balance due"); 
balance = Double.parseDouble(Cinput) ; 
try 
{ 
CustomerAccount ca = new CustomerAccount(num, balance) ; 
JOptionPane.showMessageDialog(null, "Customer #" + 
num + " has a balance of $" + balance); 
} 
catch( HighBalanceException hbe) 


JOptionPane.showMessageDialog(null, "Customer #" + 
num + " has a balance of $" + balance + 
" which is higher than the credit limit"); 





Figure 12-39 The UseCustomerAccount class 
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@® Customer #1234 has a balance of $20001.0 which is higher than the credit limit 


644 | 








Figure 12-40 Typical output of the UseCustomerAccount application 


Instead of hard coding error messages into your exception classes, as shown in Figure 12-39, 
you might consider creating a catalog of possible messages to use. This approach provides 
several advantages: 


e All the messages are stored in one location instead of being scattered throughout the 
program, making them easier to see and modify. 


e The list of possible errors serves as a source of documentation, listing potential problems 
when running the application. 


e Other applications might want to use the same catalog of messages. 


e [If your application will be used internationally, you can provide messages in multiple 
languages, and other programmers can use the version that is appropriate for their 
country. 


within any program you can code throw(new RuntimeException() ) ;. Of course, you would want to 
do so only with good reason because Java handles RuntimeExceptions for you by stopping the 
program. Because you cannot anticipate every possible error, Java’s automatic response is often the best 
course of action. 


Q You can throw any type of exception at any time, not just exceptions of your own creation. For example, 


You should not create an excessive number of special Exception types for your classes, 
especially if the Java development environment already contains an Exception class that 
will catch the error. Extra Exception types add complexity for other programmers who use 
your classes. However, when appropriate, specialized Exception classes provide an elegant 
way for you to handle error situations. They enable you to separate your error code from the 
usual, nonexceptional sequence of events; they allow errors to be passed up the stack and 
traced; and they allow clients of your classes to handle exceptional situations in the manner 
most suitable for their application. 
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Creating Your Own Exception Classes 


1. You must create your own Exception Classes for your programs to be 645 
considered truly object oriented. 








2. To create your own throwable Exception class, you should extend the 
Exception Class. 


3. The Exception class contains four constructors, including a default constructor 
and one that requires a String that contains the message that can be returned 
by the getMessage() method. 
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Using Assertions 


In Chapter 1, you learned that you might inadvertently create syntax or logical errors 
when you write a program. Syntax errors are mistakes using the Java language; they are 
compile-time errors that prevent a program from compiling and creating an executable 
file with a .class extension. 


In Chapter 1, you also learned that a program might contain logical errors even though it is 
free from syntax errors. Some logical errors cause runtime errors, or errors that cause a 
program to terminate. In this chapter, you learned how to use exceptions to handle many of 
these kinds of errors. 


Some logical errors do not cause a program to terminate but nevertheless produce incorrect 
results. For example, if a payroll program should determine gross pay by multiplying hours 
worked by hourly pay rate, but you inadvertently divide the numbers, no runtime error 
occurs and no exception is thrown, but the output is wrong. An assertion is a Java language 
feature that can help you detect such logic errors and debug a program. You use an assert 
statement to create an assertion; when you use an assert statement, you state a condition 
that should be true, and Java throws an AssertionError when it is not. 


The syntax of an assert statement is: 
assert booleanExpression : optionalErrorMessage 


The Boolean expression in the assert statement should always be true if the program is 
working correctly. The optionalErrorMessage is displayed if the booleanExpression 
is false. 
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Figure 12-41 contains an application that prompts a user for a number and passes it to a 
method that determines whether a value is even. Within the isEven() method, the remainder 
is taken when the passed parameter is divided by 2. If the remainder after dividing by 2 is 1, 
result is set to false. For example, 1, 3, and 5 all are odd, and all result in a value of 1 
when % 2 is applied to them. If the remainder after dividing by 2 is not 1, result is set 

646 to true. For example, 2, 4, and 6 all are even, and all have a 0 remainder when % 2 is applied 
to them. 





import java.util.Scanner; 
public class EvenOdd 
{ 
public static void main(String[] args) 
{ 
Scanner input = new Scanner(System.in); 
int number; 
System.out.printC"Enter a number >> "); 
number = input.nextintQ; 
ifCisEven(number) ) 
System.out.printIn(number + 
else 


is even"); 


System.out.printIn(number + " is odd"); 


} 
public static boolean isEven(Cint number) 
{ 
boolean result; 
if (number 
result 
else 
result 
return result; 





Figure 12-41 The flawed EvenOdd program without an assertion 


Figure 12-42 shows several executions of the application in Figure 12-41. The output seems 
correct until the last two executions. The values —5 and —7 are classified as even although 
they are odd. An assertion might help you to debug this application. 
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no 





fa Command Prompt =" a 


C:\Java>java EvenOdd 
" a number >> 4 


* a number >> 5 647 








Bc:\Java>java EvenOdd 
Enter a number >> —4 
-4 is even 


C:\Java>java EvenOdd 
Enter a number >> —-5 
-S is even 


C:\Java>java EvenOdd 
Enter a number >> -? 
-? is even 


C:\Java>_ 





Figure 12-42 Typical executions of the EvenOdd application 


Figure 12-43 contains a new version of the isEven() method to which the shaded 
assert statement has been added. The statement asserts that when the remainder of a 
number divided by 2 is not 1, it must be 0. If the expression is not true, a message is 
created using the values of both number and its remainder after dividing by 2. 





public static boolean isEven(int number) 


{ 
boolean result; 
ifCnumber % 2 == 1) 
result = false; 
else 


{ 
result = true; 
assert number % 2 == : number + " % 2 is 


+ number % 2; 


} 


return result; 


Figure 12-43 The flawed isEven() method with an assertion 


If you add the assertion shown in Figure 12-43 and then compile and execute the program in 
the usual way, you get the same incorrect output as in Figure 12-42. To enable the assertion, 
you must use the -ea option when you execute the program; ea stands for enable assertion. 
Figure 12-44 shows the command prompt with an execution that uses the -ea option. 
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C=\Java>java —ea EvenOdd 

Enter a number >> —-5 

mException in thread “main” java.lang.f rtionError: Number % 2 is -1 
at EvenOdd.isEven<Even0Odd. java 
at EvenOdd.main¢CEvenOdd. java:1@)> 
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Figure 12-44 Executing an application using the enable assertion option 


When the EvenOdd program executes and the user enters —5, the program displays 
the messages in Figure 12-44 instead of displaying incorrect output. You can see from the 
message that an AssertionError was thrown and that the value of —5 % 2 is —1, not 1 as 
you had assumed. The remainder operator results in a negative value when one of its 
operands is negative, making the output in this program incorrect. 


When the programmer sees that —5 % 2 is —1, the reasonable course of action is to return to 
the source code and change the logic. 


Several adjustments are possible: 


e The programmer might decide to convert the parameter to the isEven() method to its 
absolute value before using the remainder operator, as in the following: 


number = Math.abs(number) ; 


e Another option would be to change the if statement to test for even values by comparing 
number % 2 to 0 first, as follows: 


if(number % 2 == 0) 
result = true; 
else 


result false; 


Then values of both 1 and —1 would be classified as not even. 


e Other options might include displaying an error message when negative values are 
encountered, reversing the result values of true and false when the parameter is 
negative, or throwing an exception. 


An experienced programmer might have found the error in the original EvenOdd application 
without using an assertion. For example, the programmer might have previously used the 
remainder operator with a negative operand, remembered that the result might be negative, 
and changed the code accordingly. Alternatively, the programmer could have inserted 
statements to display values at strategic points in the program. However, after the mistake is 
found and fixed, any extra display statements should be removed when the final product is 
ready for distribution to users. In contrast, any assert statements can be left in place, and if 
the user does not use the -ea option when running the program, the user will see no evidence 
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that the assert statements exist. Placing assert statements in key program locations can 
reduce development and debugging time. 


You do not want to use assertions to check for every type of error that could occur in a 

program. For example, if you want to ensure that a user enters numeric data, you should 

use exception-handling techniques that provide the means for your program to recover from 649 
the mistake. If you want to ensure that the data falls within a specific range, you should use 
a decision or a loop. Assertions are meant to be helpful in the development stage of a 
program, not when it is in production and in the hands of users. 











Using Assertions 


1. All logical errors cause a program to terminate, and they should be handled by 
throwing and catching exceptions. 


2. The Boolean expression in an assert statement should always be true if the 
program is working correctly. 


3. To enable an assertion, you must use the -ea option when you execute the 
program. 
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“ns You Do It 


Creating a Class That Automatically Throws Exceptions 


Next, you create a class that contains two methods that throw exceptions but 
don’t catch them. The PickMenu class allows restaurant customers to choose from a 
dinner menu. Before you create PickMenu, you will create the Menu class, which 
lists dinner choices and allows a user to make a selection. 


1. Open a new file in your text editor, and then enter the following import 
statement, class header, and opening curly brace for the Menu class: 


import javax.swing.*; 
public class Menu 


{ 
(continues) 
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(continued) 


2. Type the following string array for three entree choices. Also include 
a String to build the menu that you will display and an integer to hold the 
650 numeric equivalent of the selection. 





private String[] entreeChoice = {Rosemary Chicken", 
"Beef Wellington", "Maine Lobster'"}; 


private String menu =""; 
private int choice; 


3. Add the displayMenuQ method, which lists each entree option with a 
corresponding number the customer can type to make a selection. Even 
though the allowable entreeChoice array subscripts are 0, 1, and 2, most users 
would expect to type 1, 2, or 3. So, you code x + 1 rather than x as the number 
in the prompt. After the user enters a selection, convert it to an integer. Return 
the String that corresponds to the user’s menu selection—the one with the 
subscript that is 1 less than the entered value. After the closing curly brace 
for the displayMenu( method, add the closing curly brace for the class. 


public String displayMenu() 
{ 
forCint x = 0; x < entreeChoice. length; ++x) 
{ 
menu = menu + "\n" + (x + 1) +" for " + 
entreeChoice[x]; 
} 
String input = JOptionPane.showInputDialog(null1, 
"Type your selection, then press Enter." + menu); 
choice = Integer.parseInt (input) ; 
return(entreeChoice[choice - 1]); 


The curly braces are not necessary in the for loop of the displayMenu() method because 
the loop contains only one statement. However, in a later exercise, you will add another statement 
within this block 





4. Examine the code within the displayMenu() method. Consider the exceptions 
that might occur. The user might not type an integer, so the parseInt() method 
can fail, and even if the user does type an integer, it might not be in the range 
allowed to access the entreeChoice array. Therefore, the displayMenu() 
method, like most methods in which you rely on the user to enter data, might 
throw exceptions that you can anticipate. (Of course, any method might throw 
an unanticipated exception.) 


5. Save the file as Menu.java, and compile the class using the javac command. 
(continues) 
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(continued) 


Creating a Class That Passes on an Exception Object 


Next, you create the PickMenu class, which lets a customer choose from the 
available dinner entree options. The PickMenu class declares a Menu and a String 
named guestChoice that holds the name of the entree the customer selects. 


651 








To enable the PickMenu class to operate with different kinds of Menus in the future, 
you will pass a Menu to PickMenu’s constructor. This technique provides two 
advantages: First, when the menu options change, you can alter the contents of 

the Menu.java file without changing any of the code in programs that use Menu. 
Second, you can extend Menu, perhaps to VegetarianMenu, LowSaltMenu, or 
KosherMenu, and still use the existing PickMenu Class. When you pass any Menu OF Menu 
subclass into the PickMenu constructor, the correct customer options appear. 


The PickMenu Class is unlikely to directly generate any exceptions because it does 
not request user input. (Keep in mind that any class might generate an exception 
for such uncontrollable events as the system not having enough memory 
available.) However, PickMenu declares a Menu object; the Menu class, because it 
relies on user input, is likely to generate an exception. 


1. Open a new file in your text editor, and then add the following first few lines 
of the PickMenu class with its data fields (a Menu and a String that reflect 
the customer’s choice): 


import javax.swing.*; 
public class PickMenu 


{ 
private Menu briefMenu; 
private String guestChoice = new StringQ; 


2. Enter the following PickMenu constructor, which receives an argument 
representing a Menu. The constructor assigns the Menu that is the argument 
to the local Menu and then calls the setGuestChoice() method, which 
prompts the user to select from the available menu. The PickMenuQ) 
constructor might throw an exception because it calls setGuestChoice(), 
which calls displayMenu(), a method that uses keyboard input and might 
throw an exception. 


public PickMenu(Menu theMenu) 
{ 
briefMenu = theMenu; 
setGuestChoice() ; 


(continues) 
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(continued) 


3. The following setGuestChoice() method displays the menu and reads keyboard 
data entry (so the method throws an exception). It also displays instructions and 
652 then retrieves the user’s selection. 





public void setGuestChoice() 
{ 
JOptionPane.showMessageDialog(null, 
"Choose from the following menu:"); 
guestChoice = briefMenu.displayMenu() ; 


} 


4. Add the following getGuestChoice() method that returns a guest's String 
selection from the PickMenu class. Also, add a closing curly brace for the class. 


public String getGuestChoice() 
{ 


} 


return(guestChoice) ; 


} 
5. Save the file as PickMenu.java, and compile it using the javac command. 


Creating an Application That Can Catch Exceptions 


You have created a Menu class that simply holds a list of food items, displays itself, and 
allows the user to make a selection. You also created a PickMenu Class with fields that 
hold a user’s specific selection from a given menu and methods to get and set values 
for those fields. The PickMenu class might throw exceptions, but it contains no 
methods that catch those exceptions. Next, you write an application that uses the 
PickMenu Class. This application can catch exceptions that PickMenu throws. 


1. Open a new file in your text editor, and start entering the following PlanMenu class, 
which has just one method—a mainQ method: 


import javax.swing.*; 
public class PlanMenu 


{ 


public static void main(String[] args) 


{ 


2. Construct the following Menu named briefMenu, and declare a PickMenu 
object that you name entree. You do not want to construct a PickMenu object 
yet because you want to be able to catch the exception that the PickMenu 
constructor might throw. Therefore, you want to wait and construct the PickMenu 
object within a try block. For now, you just declare entree and assign it nu11. 
Also, you declare a String that holds the customer’s menu selection. 


(continues) 
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(continued) 


Menu briefMenu = new MenuQ); 
PickMenu entree = null; 
String guestChoice = new String(); 653 








3. Write the following try block that constructs a PickMenu item. If the construction 
is successful, the next statement assigns a selection to the entree object. 
Because entree IS a PickMenu object, it has access to the getGuestChoice() 
method in the PickMenu class, and you can assign the method’s returned value to 
the guestChoice String. 


try 

{ 
PickMenu selection = new PickMenu(briefMenu) ; 
entree = selection; 
guestChoice = entree.getGuestChoice() ; 


} 


4. The catch block must immediately follow the try block. When the try block 
fails, guestChoice will not have a valid value, so recover from the exception by 
assigning a value to guestChoice within the following catch block: 


catch(Exception error) 
{ 
guestChoice = "an invalid selection"; 


} 


5. After the catch block, the application continues. Use the following code to display 
the customer's choice at the end of the PlanMenu application, and then add 
closing curly braces for the main® method and the class: 


JOptionPane. showMessageDialog(nul1, 
"You chose " + guestChoice) ; 


} 


6. Save the file as PlanMenu.java, and then compile and execute it. Read the 
instructions, click OK, choose an entree by typing its number from the menu, 
and click OK again. Confirm that the menu selection displayed is the one you 
chose, and click OK to dismiss the last dialog box. Figure 12-45 shows the 
first dialog box of instructions, the menu that appears, and the output when 
the user selects option 3. 


(continues) 
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[2] Type your selection, then press Enter. 
1 for Rosemary Chicken 


2 for Beef Wellington 


3 for Maine Lobster 


[3 
N 


@ Choose from the following menu: 
































Message 





@ You chose Maine Lobster 





Figure 12-45 Typical execution of the PlanMenu application 


7. The PlanMenu application works well when you enter a valid menu selection. One 
way that you can force an exception is to enter an invalid menu selection at the 
prompt. Run the PlanMenu application again, and type 4, A, or any invalid value 
at the prompt. Entering 4 produces an ArrayIndexOutOfBoundsException, 
and entering A produces a NumberFormatException. If the program lacked the 
try..catch pair, either entry would halt the program. However, because the 
setGuestChoice() method in the PickMenu Class throws the exception and the 
PlanMenu application catches it, guestChoice takes on the value “an invalid 
selection” and the application ends smoothly, as shown in Figure 12-46. 


@® You chose an invalid selection 





Figure 12-46 Exceptional execution of the PlanMenu application 
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(continued) 
Extending a Class That Throws Exceptions 


An advantage to using object-oriented exception handling techniques is that you gain 

the ability to handle error conditions differently within each program you write. Next, 655 
you extend the Menu class to create a class named VegetarianMenu. Subsequently, 
when you write an application that uses PickMenu with a VegetarianMenu object, you 
can deal with any thrown exception differently than when you wrote the PlanMenu 
application. 








1. Open the Menu.java file in your text editor, and change the access specifier for 
the entreeChoice array from private to protected. That way, when you extend 
the class, the derived class will have access to the array. Save the file, and 
recompile it using the javac command. 


2. Open anew file in your text editor, and then type the following class header for the 
VegetarianMenu Class that extends Menu: 


public class VegetarianMenu extends Menu 


{ 
3. Provide new menu choices for the VegetarianMenu as follows: 


String[] vegEntreeChoice = {"Spinach Lasagna", 
"Cheese Enchiladas", "Fruit Plate"}; 


4. Add the following constructor that calls the superclass constructor and assigns 
each vegetarian selection to the Menu superclass entreeChoice array, and then 
add the closing curly brace for the class: 


public VegetarianMenu() 


{ 
super (); 
for(int x = 0; x < vegEntreeChoice. length; ++x) 
entreeChoice[x] = vegEntreeChoice[x]; 
} 


} 
5. Save the class as VegetarianMenu.java, and then compile it. 


6. Now write an application that uses VegetarianMenu. You could write any program, 
but for demonstration purposes, you can simply modify PlanMenu.java. Open the 
PlanMenu.java file in your text editor, then immediately save it as 
PlanVegetarianMenu.java. 


7. Change the class name in the header to PlanVegetarianMenu. 


(continues) 
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8. Change the first statement within the main@ method as follows so it declares a 
VegetarianMenu instead of a Menu 


656 VegetarianMenu briefMenu = new VegetarianMenu() ; 





9. Change the guestChoice assignment statement in the catch block as follows so it 
is specific to the program that uses the VegetarianMenu: 


guestChoice = "an invalid vegetarian selection"; 


10. Save the file, compile it, and run the application. When you see the vegetarian 
menu, enter a valid selection and confirm that the program works correctly. 
Run the application again, and enter an invalid selection. The error message 
shown in Figure 12-47 identifies your invalid entry as “an invalid vegetarian 
selection”. Remember that you did not change the PickMenu class. Your new 
PlanVegetarianMenu application uses the PickMenu class that you wrote and 
compiled before a VegetarianMenu ever existed. However, because PickMenu 
throws uncaught exceptions, you can handle those exceptions as you see fit in 
any new applications in which you catch them. Click OK to end the application. 


Message <i 





@ You chose an invalid vegetarian selection 














Figure 12-47 Output of the PlanVegetarianMenu application when the user makes an 
invalid selection 


Creating an Exception Class 


Besides using built-in classes that derive from Exception, such as 
NumberFormatException and IndexOutOfBoundsException, yOU Can create your own 
Exception Classes. For example, suppose that although you have asked a user to type 
a number representing a menu selection, you realize that some users might mistakenly 
type the initial letter of an option, such as R for Rosemary Chicken. Although the user 
has made an error, you want to treat this type of error more leniently than other errors, 
such as typing a letter that has no discernable connection to the presented menu. In 
the next section, you create a MenuException Class that you can use with the Menu 
class to represent a specific type of error. 


(continues) 
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(continued) 


1. Open a new file in your text editor, and enter the MenuException Class. The class 
extends Exception. Its constructor requires a String argument, which is passed 
to the parent class to be used as a return value for the getMessage() method. 657 








public class MenuException extends Exception 


{ 


public MenuException(String choice) 


{ 


} 
} 


2. Save the file as MenuException.java, and compile it. 


super (choice); 


Using an Exception You Created 


Next, you modify the Menu, PickMenu, and PlanMenu Classes to demonstrate how to 
uSe a MenuException object. 


1. Open the Menu class in your text editor, and immediately save the file as 
Menu2.java. 


2. Change the class name to Menu2. 


3. At the end of the list of class data fields, add an array of characters that can hold 
the first letter of each of the entrees in the menu. 


protected char initial[] = new char[entreeChoice. length]; 


4. At the end of the method header for the displayMenu( class, add the following 
clause: 


throws MenuException 


You add this clause because you are going to add code that throws such an 
exception. 


5. Within the displayMenu() method, just before the closing curly brace of the for 
loop that builds the menu String, add a statement that takes the first character of 
each entreeChoice and stores it in a corresponding element of the initial 
array. At the end of the for loop, the initial array holds the first character of 
each available entree. 


initial [x] = entreeChoice[x] .charAt(0); 


6. After displaying the JoptionPane dialog box that displays the menu and receives 
the user’s input, add a loop that compares the first letter of the user’s choice to 
each of the initials of valid menu options. If a match is found, throw a new 


(continues) 
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instance of the MenuException Class that uses the corresponding entree as its 
String argument. In other words, when this thrown MenuException is Caught by 
658 another method, the assumed entree is the String returned by the 
getMessage() method. By placing this test before the call to parseIntQ, 
you cause entries of R, B, or M to throw a MenuException before they can 
Cause a NumberFormatException. 





forCint y = 0; y < entreeChoice. length; ++y) 
ifCinput.charAt(0) == initial [y]) 
throw (new MenuException(entreeChoice[y])); 
7. Compare your new class with Figure 12-48, in which all of the changes to the Menu 
Class are shaded. 





import javax.swing.*; 
public class Menu2 
{ 
protected String[] entreeChoice = {"Rosemary Chicken", 
"Beef Wellington", "Maine Lobster"}; 
private String menu = ""; 
private int choice; 
protected char initial[] = new char[entreeChoice. length] ; 
public String displayMenu() throws MenuException 
{ 
forCint x = 0; x < entreeChoice. length; ++x) 
{ 
menu = menu + "\n" + (x + 1) 4+." for " + 
entreeChoice[x]; 
initial[x] = entreeChoice[x].charAt(0); 
} 
String input = JOptionPane.showInputDialog(null, 
"Type your selection, then press Enter." + menu); 
forCint y = 0; y < entreeChoice. length; ++y) 
ifCinput.charAt(O) == initial[y]) 
throw(Cnew MenuException(entreeChoice[y])); 
choice = Integer.parseInt (input) ; 
return(entreeChoice[choice - 1]); 


} 
| 


Figure 12-48 The Menu2 class 








8. Save the class, and compile it. 


9. Open the PickMenu file in your text editor, and immediately save it as 


PickMenu2.java. 
(continues) 
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(continued) 


10. Change the class name to PickMenu2, and change the declaration of the Menu 
object to a Menu2 object. Change the constructor name to PickMenu2 and its 
argument to type Menu2. Also add a throws clause to the PickMenu2 constructor 659 
header so that it throws a MenuException. This constructor does not throw an 
exception directly, but it calls the setGuestChoice() method, which calls the 
displayMenu() method, which throws a MenuException. 








11. Add the following throws clause to the setGuestChoice() method header: 
throws MenuException 


12. Compare your modifications to the PickMenu2 class in Figure 12-49, in which the 
changes from the PickMenu class are shaded. Save your file, and compile it. 





| import javax.swing.*; 
public class PickMenu2 
| at 
private Menu2 briefMenu; 
private String guestChoice = new StringQ; 
public PickMenu2(Menu2 theMenu) throws MenuException 
{ 
briefMenu = theMenu; 
setGuestChoice(); 
} 
public void setGuestChoice() throws MenuException 
{ 
JOptionPane. showMessageDialog(null, 
"Choose from the following menu:"); 
guestChoice = briefMenu.displayMenu() ; 
} 
public String getGuestChoice(Q) 
{ 


i 


return(guestChoice) ; 














Figure 12-49 The PickMenu2 class 


13. Open the PlanMenu.java file in your text editor, and immediately save it as 
PlanMenu2.java. 


(continues) 
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14. Change the class name to PlanMenu2. Within the main method, declare a Menu2 
object and a PickMenu2 reference instead of the current Menu object and 
660 PickMenu reference. 





15. Within the try block, change both references of PickMenu to PickMenu2. 


Using Figure 12-50 as a reference, add a catch block after the try block and 
before the existing catch block. This catch block will catch any thrown 
MenuExceptions and display their messages. The message will be the name of 
a menu item, based on the initial the user entered. All other Exception objects, 
including NumberFormatExceptions and IndexOutOfBoundsExceptions, will fall 
through to the second catch block and be handled as before. 




















import javax.swing.*; 
public class PlanMenu2 
{ 
public static void main(String[] args) 
{ 
Menu2 briefMenu = new Menu2(); 
PickMenu2 entree = null; 
String guestChoice = new StringQ; 
try 
{ 
PickMenu2 selection = new PickMenu2(briefMenu) ; 
entree = selection; 
guestChoice = entree.getGuestChoice() ; 
} 
catch(MenuException error) 


{ 
} 


catch(Exception error) 


{ 
5 


JOptionPane.showMessageDialog(null, 
"You chose " + guestChoice) ; 


guestChoice = error.getMessage() ; 


guestChoice = "an invalid selection"; 

















Figure 12-50 The PlanMenu2 class 
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(continued) 


16. Save the file, then compile and execute it several times. When you are asked 
to make a selection, try entering a valid number, an invalid number, an initial 
letter that is part of the menu, and a letter that is not one of the initial menu 661 
letters, and observe the results each time. Whether or not you enter a valid 
number, the application works as expected. Entering an invalid number still 
results in an error message. When you enter a letter or a string of letters, the 
application assumes your selection is valid if you enter the same initial letter, 
using the same case, as one of the menu options. 








Don't Do It 


e Don’t forget that all the statements in a try block might not execute. If an exception is 
thrown, no statements after that point in the try block will execute. 


e Don’t forget that you might need a nextLineQ) method call after an attempt to read 
numeric data from the keyboard throws an exception. 


e Don’t forget that a variable declared in a try block goes out of scope at the end of 
the block. 


e Don't forget that when a variable gets its usable value within a try block, you must ensure 
that it has a valid value before attempting to use it. 


e Don't forget to place more specific catch blocks before more general ones. 


e Don't forget to write a throws clause for a method that throws a checked exception but 
does not handle it. 


e Don't forget to handle any checked exception thrown to your method either by writing a 
catch block or by listing it in your method's throws clause. 


Key Terms 


An exception is an unexpected or error condition. 
Exception handling is an object-oriented technique for managing errors. 


Runtime exceptions are unplanned exceptions that occur during a program’s execution. 
The term is also used more specifically to describe members of the RuntimeException class. 
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The Error class represents more serious errors than the Exception class—those from which 
your program usually cannot recover. 


The Exception class comprises less serious errors than those from the Error class; the 
Exception class represents unusual conditions that arise while a program is running and from 
662 which the program can recover. 





A crash is a premature, unexpected, and inelegant end to a program. 


A stack trace history list, or more simply a stack trace, displays all the methods that were 
called during program execution. 


The term mission critical refers to any process that is crucial to an organization. 


Fault-tolerant applications are designed so that they continue to operate, possibly at a 
reduced level, when some part of the system fails. 


Robustness represents the degree to which a system is resilient to stress, maintaining correct 
functioning. 


A try block is a block of code that might throw an exception that can be handled by a 
subsequent catch block. 


A catch block is a segment of code that can handle an exception that might be thrown by the 
try block that precedes it. 


A throw statement is one that sends an exception out of a block or a method so it can be 
handled elsewhere. 


A finally block is a block of code that holds statements that must execute at the end of a 
try..catch sequence, whether or not an exception was thrown. 


Exception specification is the practice of using the keyword throws followed by an 
Exception type in the method header. If a method throws a checked Exception object that 
it will not catch but will be caught by a different method, you must use an exception 
specification. 


Unchecked exceptions are those from which an executing program cannot reasonably be 
expected to recover. 









Checked exceptions are those that a programmer should plan for and from which a program 
should be able to recover. 


The catch or specify requirement is the Java rule that checked exceptions require catching or 
declaration. 


Syntactic sugar is a term to describe aspects of a computer language that make it “sweeter,” 
or easier, for programmers to use. 


Syntactic salt describes a language feature designed to make it harder to write bad code. 
The memory location known as the call stack is where the computer stores the list of method 


locations to which the system must return. 
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Chapter Sumary iii 


An assertion is a Java language feature that can help you detect logic errors and debug a 
program. 


An assert statement creates an assertion. 


Chapter Summary 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce: iti 


An exception is an unexpected or error condition. Exception handling is the name for the 
object-oriented techniques that manage such errors. In Java, the two basic classes of 
errors are Error and Exception; both descend from the Throwable class. 


In object-oriented terminology, a try block holds code that might cause an error and 
throw an exception, and a catch block processes the error. 


You can place as many statements as you need within a try block, and you can catch as 
many exceptions as you want. If you try more than one statement, only the first error- 
generating statement throws an exception. As soon as the exception occurs, the logic 
transfers to the catch block, which leaves the rest of the statements in the try block 
unexecuted. When a program contains multiple catch blocks, the first matching catch 
block executes, and each remaining catch block is bypassed. 


When you have actions you must perform at the end of a try..catch sequence, you can 
use a finally block that executes regardless of whether the preceding try block identifies 
an exception. Usually, you use a finally block to perform cleanup tasks. 


Besides clarity, an advantage to object-oriented exception handling is the flexibility it 
allows in the handling of error situations. Each calling application might need to handle 
the same error differently, depending on its purpose. 


When you write a method that might throw a checked exception that is not caught within 
the method, you must type the clause throws <name>Exception after the method header 
to indicate the type of Exception that might be thrown. Methods in which you explicitly 
throw a checked exception require a catch or a declaration. 


The memory location known as the call stack is where the computer stores the list of 
method locations to which the system must return. When you catch an exception, you 
can call printStackTrace() to display a list of methods in the call stack so you can 
determine the location of the exception. 


Java provides over 40 categories of Exceptions that you can use in your programs. 
However, Java’s creators could not predict every condition that might be an Exception in 
your applications, so Java also allows you to create your own Exceptions. To create your 
own throwable Exception class, you must extend a subclass of Throwable. 


An assertion is a Java language feature that can help you detect logic errors and debug a 
program. When you use an assertion, you state a condition that should be true, and Java 
throws an AssertionError when it is not. 
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Review Questions 


In object-oriented programming terminology, an unexpected or error condition 
is a(n) 


a. anomaly c. deviation 

b. aberration d. exception 
All Java Exceptions are 

a. Errors c. Throwables 
b. RuntimeExceptions d. Omissions 
Which of the following statements is true? 


Exceptions are more serious than Errors. 
Errors are more serious than Exceptions. 


Errors and Exceptions are equally serious. 


ao Ff P 


Exceptions and Errors are the same thing. 


The method that ends the current application and returns control to the operating 
system is 


a. System.endQ c. System.exit( 

b. System.done() d. System.abortQ 

In object-oriented terminology, you __________ a procedure that might not 
complete correctly. 

a. try c. handle 

b. catch d. encapsulate 

A method that detects an error condition or Exception _________ an 
Exception. 

a. throws c. handles 

b. catches d. encapsulates 


A try block includes all of the following elements except 


the keyword try 
the keyword catch 
curly braces 


ao F PS 


statements that might cause Exceptions 
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8. The segment of code that handles or takes appropriate action following an 


exception is a _______ block. 
a. try c. throws 
b. catch d. handles 
665 
9. You within a try block. 








a. must place only a single statement 
b. can place any number of statements 
c. must place at least two statements 
d. must place a catch block 


10. If you include three statements in a try block and follow the block with three 
catch blocks, and the second statement in the try block throws an Exception, 
then 
a. the first catch block executes 
b. the first two catch blocks execute 
c. only the second catch block executes 
d._ the first matching catch block executes 


11. Whena try block does not generate an Exception and you have included multiple 
catch blocks, 


a. they all execute 
b. only the first one executes 
c. only the first matching one executes 
d. no catch blocks execute 
12. The catch block that begins catch(Exception e) can catch Exceptions of 
type 
a. IOException c. both of the above 
b. ArithmeticException d. none of the above 






13. The code within a finally block executes when the try block 
identifies one or more Exceptions 

does not identify any Exceptions 

either a or b 


ao F PS 


neither a nor b 
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14. An advantage to using a try..catch block is that exceptional events 


are 
a. eliminated c. integrated with regular events 
b. reduced d. isolated from regular events 
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15. Which methods can throw an Exception? 

methods with a throws clause 

methods with a catch block 

methods with both a throws clause and a catch block 


ao Ff 2 


any method 


16. A method can 


a. check for errors but not handle them 
b. handle errors but not check for them 
c. either of the above 

d. neither of the above 


17. Which of the following is least important to know if you want to be able to use a 
method to its full potential? 

the method’s return type 

the type of arguments the method requires 

the number of statements within the method 


ao Ff PS 


the type of Exceptions the method throws 


18. The memory location where the computer stores the list of method locations to 
which the system must return is known as the 
a. registry c. chronicle 
b. call stack d. archive 


19. You can get a list of the methods through which an Exception has traveled by 












using the _________ method. 
a. getMessage() c. getPath() 
b. callStackQ) d.  printStackTrace() 
20. A(n)__________ is a statement used in testing programs that should be true; if it 


is not true, an Exception is thrown. 


a. assertion c. verification 
b. throwable d. declaration 
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Exercises 


Programming Exercises 





1. Write an application named BadSubscriptCaught in which you declare an array 667 
of 10 first names. Write a try block in which you prompt the user for an integer 
and display the name in the requested position. Create a catch block that catches 
the potential ArrayIndexOutOfBoundsException thrown when the user enters a 
number that is out of range. The catch block should also display an error message. 
Save the file as BadSubscriptCaught.java. 








2. The Double.parseDouble() method requires a String argument, but it fails 
if the String cannot be converted to a floating-point number. Write an 
application in which you try accepting a double input from a user and catch a 
NumberFormatException if one is thrown. The catch block forces the number to 
0 and displays an appropriate error message. Following the catch block, display the 
number. Save the file as TryToParseDouble.java. 


3. In Chapter 9, you wrote a program named MeanMedian that allows a user to enter 
five integers and then displays the values, their mean, and their median. Now, 
modify the program to throw an exception if an entered value is not an integer. 
If an exception is thrown, display an appropriate message and allow the user to 
reenter the value. Save the file as MeanMedianHandleException.java. 


4, Write an application that prompts the user to enter a number to use as an 
array size, and then attempt to declare an array using the entered size. If the 
array is created successfully, display an appropriate message. Java generates a 
NegativeArraySizeException if you attempt to create an array with a negative 
size, and it creates a NumberFormatException if you attempt to create an array 
using a nonnumeric value for the size. Use a catch block that executes if the array 
size is nonnumeric or negative, displaying a message that indicates the array was 
not created. Save the file as NegativeArray.java. 


5. Write an application that throws and catches an ArithmeticException when 
you attempt to take the square root of a negative value. Prompt the user for an 
input value and try the Math.sqrt(© method on it. The application either displays 
the square root or catches the thrown Exception and displays an appropriate 
message. Save the file as SqrtException.java. 













6. Create a ProductException class whose constructor receives a String that 
consists of a product number and price. Save the file as ProductException.java. 
Create a Product class with two fields, productNum and price. The Product 
constructor requires values for both fields. Upon construction, throw a 
ProductException if the product number does not consist of three digits, if the 
price is less than $0.01, or if the price is over $1,000. Save the class as Product.java. 
Write an application that establishes at least four Product objects with valid and 
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7. 


10. 


invalid values. Display an appropriate message when a Product object is created 
successfully and when one is not. Save the file as ThrowProductException.java. 


a. Create an IceCreamConeException class whose constructor receives a String 
that consists of an ice cream cone’s flavor and an integer representing the 
number of scoops in the IceCreamCone. Pass this String to the 
IceCreamConeException’s parent so it can be used in a getMessage() call. 
Save the class as IceCreamConeException.java. Create an IceCreamCone class 
with two fields—flavor and scoops. The IceCreamCone constructor calls two 
data-entry methods—setFlavor() and setScoops(). The setScoops() 
method throws an IceCreamConeException when the scoop quantity exceeds 
three. Save the class as IceCreamCone.java. Write an application that 
establishes several IceCreamCone objects and handles the Exceptions. Save the 
file as ThrowIlceCream.java. 


b. Create an IceCreamCone2 class in which you modify the IceCreamCone setFlavor() 
method to ensure that the user enters a valid flavor. Allow at least four flavors 
of your choice. If the user’s entry does not match a valid flavor, throw an 
IceCreamConeException. Write an application that establishes several 
IceCreamCone objects and demonstrates the handling of the new Exception. 
Save the new class file as leeCreamCone2.java, and save the new application 
file as ThrowIlceCream2.java. 


Write an application that displays a series of at least five student ID numbers 
(that you have stored in an array) and asks the user to enter a numeric test score 
for the student. Create a ScoreException class, and throw a ScoreException 

for the class if the user does not enter a valid score (less than or equal to 100). 
Catch the ScoreException, and then display an appropriate message. In addition, 
store a O for the student’s score. At the end of the application, display all the 
student IDs and scores. Save the files as ScoreException.java and TestScore.java. 


Write an application that displays a series of at least 10 student ID numbers 

(that you have stored in an array) and asks the user to enter a test letter grade for 
the student. Create an Exception class named GradeException that contains a 
static public array of valid grade letters (‘A’, ‘B’, ‘C’, ‘D’, ‘F’, and ‘T’) you can use 
to determine whether a grade entered from the application is valid. In your 
application, throw a GradeException if the user does not enter a valid letter 
grade. Catch the GradeException, and then display an appropriate message. In 
addition, store an ‘T’ (for Incomplete) for any student for whom an exception is 
caught. At the end of the application, display all the student IDs and grades. 

Save the files as GradeException.java and TestGrade.java. 


Create a DataEntryException class whose getMessage() method returns 
information about invalid integer data. Write a program named GetIDAndAge that 
continually prompts the user for an ID number and an age until a terminal 0 is 
entered for both. Throw a DataEntryException if the ID is not in the range of 
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valid ID numbers (0 through 999), or if the age is not in the range of valid ages 
(0 through 119). Catch any DataEntryException or InputMismatchException 
that is thrown, and display an appropriate message. Save the files as 
DataEntryException.java and GetIDAndAge.java. 


11. A company accepts user orders by part numbers interactively. Users might 


669 
make the following errors as they enter data: 








e The part number is not numeric. 

e The quantity is not numeric. 

e The part number is too low (less than 0). 

e The part number is too high (more than 999). 

e The quantity ordered is too low (less than 1). 

e The quantity ordered is too high (more than 5,000). 


Create a class that stores an array of usable error messages; save the file 

as DataMessages.java. Create a DataException class; each object of this class 
will store one of the messages. Save the file as DataException.java. Create 

an application that prompts the user for a part number and quantity. Allow for 
the possibility of nonnumeric entries as well as out-of-range entries, and display the 
appropriate message when an error occurs. If no error occurs, display the 
message “Valid entry”. Save the program as PartAndQuantityEntry.java. 


12. A company accepts user orders for its products interactively. Users might make 
the following errors as they enter data: 


e The item number ordered is not numeric. 

e The quantity is not numeric. 

e The item number is too low (less than 0). 

e The item number is too high (more than 9999). 
e The quantity ordered is too low (less than 1). 

e The quantity ordered is too high (more than 12). 


e The item number is not a currently valid item. 







Although the company might expand in the future, its current inventory consists of 
the items listed in Table 12-1. 
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Item Number Price ($) 
111 0.89 
222 1.47 
670 333 2.43 
AA 5.99 


Wel) (5 Item numbers and prices 


Create a class that stores an array of usable error messages; save the file as 
OrderMessages.java. Create an OrderException class that stores one of 

the messages; save the file as OrderException.java. Create an application 

that contains prompts for an item number and quantity. Allow for the possibility 
of nonnumeric entries as well as out-of-range entries and entries that do not 
match any of the currently available item numbers. The program should display 
an appropriate message if an error has occurred. If no errors exist in the entered 
data, compute the user’s total amount due (quantity times price each) and display 
it. Save the program as PlaceAnOrder.java. 


13. a. Gadgets by Mail sells many interesting items through its catalogs. Write an 
application that prompts the user for order details, including item numbers 
and quantity of each item ordered, based on the available items shown in 


Table 12-2. 
tem # Description Pace fl 
101 Electric hand warmer 12.99 
124 Battery-operated plant waterer 7.55 
256 Gerbil trimmer 9.99 
512 Talking bookmark 6.89 


WE) Items offered by Gadgets by Mail 











The shipping and handling fee for an order is based on the total order price, as 
shown in Table 12-3. 





Price of Order (S) Shipping and Handling ($) 
0-24.99 5.55 
25.00-49.99 8.55 
50.00 or more 11.55 


E):)(-Sil) ~=Shipping and handling fees charged by Gadgets by Mail 
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Create the following classes: 


e Gadget, which contains an item number, description, and price for a gadget; a 
constructor that sets all the fields; and get methods to retrieve the field values. 


e Order, which contains an order number, customer name, and address (assume you 
need just a street address, not city, state, and zip code); a list of item numbers 671 
ordered (up to four); the total price of all items ordered; and a shipping and 
handling fee for the order. Include a constructor to set the field values and get 
methods to retrieve the field values. 








e GadgetOrderTaker, which is an interactive application that takes four customer 
orders. The class contains an array of the four Gadget objects offered (from 
Table 12-2). The application prompts each user for a name and street address and 
assigns a unique order number to each customer, starting with 101. The 
application asks each user to enter an item number and quantity wanted. When 
the user enters 999 for the item number, the order is complete, and the next 
customer can enter data. Each customer can order up to four item numbers. 
When a customer’s order is complete (the customer has entered 999 for an item 
number, or has ordered four different items), calculate the shipping and handling 
charges. After four customers have placed Orders, display each Order’s data, 
including the order number, the name and address of the customer, and the list of 
items ordered, including the item number, description, and price of each Order, 
the total price for the order, and the shipping and handling charge. The 
GadgetOrderTaker class handles all thrown Exceptions by displaying an 
explanatory message and ending the application. 


e OrderException, which is an Exception that is created and thrown under any of 
the following conditions: 


e A customer attempts to order more than four different items. 
e Accustomer orders more than 100 of any item. 
e A customer enters an invalid item number. 

e Also, catch the Exception generated by either of these conditions: 


e A customer enters a nonnumeric character as the item number. 








e A customer enters a nonnumeric character as the quantity. 


Save the files as Gadget.java, Order.java, GadgetOrderTaker.java, and 
OrderException.java. 


b. The GadgetOrderTaker class handles all thrown Exceptions by displaying an 
explanatory message and ending the application. Create a new application that 
handles all Exceptions by requiring the user to reenter the offending data. Save 
the file as GadgetOrderTaker2.java. 
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Debugging Exercises 


Each of the following files in the Chapter12 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and fix 
the program. After you correct the errors, save each file using the same filename 
preceded with Fix. For example, DebugTwelvel java will become FixDebugTwelvel. 
java. You will also use a file named DebugEmployeeIDException.java with the 
DebugTwelve4.java file. 


a. DebugTwelvel.java c. DebugTwelve3.java 
b. DebugTwelve2.java d. DebugTwelve4.java 
Game Zone 


In Chapter 1, you created a class called RandomGuess. In this game, the application 
generates a random number for a player to guess. In Chapter 5, you improved the 
application to display a message indicating whether the player’s guess was correct, 
too high, or too low. In Chapter 6, you further improved the game by adding a loop 
that continually prompts the user to enter the correct value, if necessary. As written, 
the game should work as long as the player enters numeric guesses. However, if the 
player enters a letter or other nonnumeric character, the game throws an exception. 
Discover the type of Exception thrown, then improve the game by handling the 
exception so that the user is informed of the error and allowed to attempt to enter 
the correct data again. Save the file as RandomGuess4.java. 


In Chapter 8, you created a Quiz class that contains an array of 10 multiple-choice 
questions to which the user was required to respond with an A, B, or C. At the time, 
you knew how to handle the user’s response if an invalid character was entered. 
Rerun the program now to determine whether an exception is thrown if the user 
enters nothing—that is, the user just presses the Enter key without making an entry. 
If so, improve the program by catching the exception, displaying an appropriate 
error message, and presenting the same question to the user again. Save the file as 
QuizWithExceptionsCaught.java. 


Case Problems 


In Chapter 11, you created an interactive StaffDinnerEvent class that obtains all 
the data for a dinner event for Carly’s Catering, including details about the staff 
members required to work at the event. Now, modify the class so that it becomes 
immune to user data entry errors by handling exceptions for each numeric entry. 
Each time the program requires numeric data—for example, for the number of 
guests, selected menu options, and staff members’ salaries—continuously prompt 
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Exercises 


the user until the data entered is the correct type. Save the revised program as 
StaffDinnerEvent.java. 


2. In Chapter 11, you created an interactive RentalDemo class that obtains all the data for 
four rentals from Sammy’s Seashore Rentals, including details about the contract 
number, length of the rental, and equipment type. Now, modify the class so that it 
becomes immune to user data entry errors by handling exceptions for each numeric 
entry. Each time the program requires numeric data—for example, for the rental 
period—continuously prompt the user until the data entered is the correct type. Save 
the revised program as RentalDemo.java. 
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File Input and Output 


In this chapter, you will: 


Learn about computer files 


(©) 


Use the Path and Files classes 


(©) 


Learn about file organization, streams, and buffers 


(©) 


Use Java’s IO classes to write to and read from a file 


(©) 


Create and use sequential data files 


(©) 


Learn about random access files 


(©) 


Write records to a random access data file 


(©) 


Read records from a random access data file 


(©) 





Unless noted otherwise, all images are © 2014 Cengage Learning 
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CHAPTER 13 File Input and Output 


Understanding Computer Files 


Data items can be stored on two broad types of storage devices in a computer system: 


e Volatile storage is temporary; values that are volatile, such as those stored in variables, 
are lost when a computer loses power. Random access memory (RAM) is the temporary 
676 storage within a computer. When you write a Java program that stores a value in a 
variable, you are using RAM. Most computer professionals simply call volatile 
storage memory. 





e Nonvolatile storage is permanent storage; it is not lost when a computer loses power. 
When you write a Java program and save it to a disk, you are using permanent storage. 


example, a temporary variable might exist for several hours in a large program or one that the user forgets to 
close, but a permanent piece of data might be saved and then deleted within a few seconds. In recent years, 
the distinction between memory and storage has blurred because many systems automatically save data to a 
nonvolatile device and retrieve it after a power interruption. Because you can erase data from files, some 
programmers prefer the term “persistent storage” to permanent storage. In other words, you can remove data 
from a file stored on a device such as a disk drive, So it is not technically permanent. However, the data remains 
in the file even when the computer loses power; so, unlike with RAM, the data persists, or perseveres. 


Q When discussing computer storage, temporary and permanent refer to volatility, not length of time. For 


A computer file is a collection of data stored on a nonvolatile device. Files exist on permanent 
storage devices, such as hard disks, Zip disks, USB drives, reels or cassettes of magnetic tape, 
and compact discs. 


You can categorize files by the way they store data: 


e Text files contain data that can be read in a text editor because the data has been encoded 
using a scheme such as ASCII or Unicode. (See Appendix B for more information on 
Unicode.) Some text files are data files that contain facts and figures, such as a payroll file 
that contains employee numbers, names, and salaries; some files are program files or 
application files that store software instructions. You have created many such files 
throughout this book. 


e Binary files contain data that has not been encoded as text. Their contents are in binary 
format, which means that you cannot understand them by viewing them in a text editor. 
Examples include images, music, and the compiled program files with a .class extension 
that you have created using this book. 


Although their contents vary, files have many common characteristics—each file has a size 
that specifies the space it occupies on a section of disk or other storage device, and each file 
has a name and a specific time of creation. 


Computer files are the electronic equivalent of paper files stored in office file cabinets. When 
you store a permanent file, you can place it in the main or root directory of your storage 
device. If you compare computer storage to using a file cabinet drawer, saving to the root 
directory is equivalent to tossing a loose document into the drawer. However, for better 
organization, most office clerks place documents in folders, and most computer users 
organize their files into folders or directories. Users also can create folders within folders to 
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form a hierarchy. A complete list of the disk drive plus the hierarchy of directories in which a 
file resides is its path. For example, the following is the complete path for a Windows file 
named Data.txt, which is saved on the C drive in a folder named Chapter.13 within a folder 
named Java: 


C:\Java\Chapter.13\Data. txt 677 








In the Windows operating system, the backslash ( \ ) is the path delimiter—the character used 
to separate path components. In the Solaris (UNIX) operating system, a slash (/ ) is used as 
the delimiter. 


When you work with stored files in an application, you typically perform the following tasks: 
e Determining whether and where a path or file exists 

e Opening a file 

e Writing to a file 

e Reading from a file 

e Closing a file 


e Deleting a file 


Java provides built-in classes that contain methods to help you with these tasks. 





Understanding Computer Files 


1. An advantage of modern computer systems is that both internal computer 
memory and disk storage are nonvolatile. 


2. Data files contain facts and figures; program files store software instructions 
that might use data files. 


3. Acomplete list of the disk drive plus the hierarchy of directories in which a file 
resides is the file’s path. 
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Using the Path and Files Classes 


You can use Java's Path Class to create objects that contain information about files and 
directories, such as their locations, sizes, creation dates, and whether they even exist. You use 
the Files class to perform operations on files and directories, such as deleting them, 
determining their attributes, and creating input and output streams. 
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CHAPTER 13 File Input and Output 


You can include the following statement in a Java program to use both the Path and Files 
classes: 


import java.nio.file.*; 


The xio in java.nio stands for new input/output because its classes are “new” in that they were 
678 developed long after the first Java versions. The Path and Fi es classes are new in Java 7; they 
replace the functionality of the File class used in older Java versions. If you search the Web 
for Java file-handling programs, you will find many that use the older File class. 





Creating a Path 


To create a Path, you first determine the default file system on the host computer by using a 
statement such as the following: 


FileSystem fs = FileSystems.getDefaultQ; 


Notice that this statement creates a FileSystem object using the getDefault() method in 
the FileSystems class. The statement uses two different classes. The FileSystem class, 
without an ending s, is used to instantiate the object. FileSystems, with an ending s, is a class 
that contains factory methods, which assist in object creation. 


After you create a FileSystem object, you can define a Path using the getPath() method 
with it: 


Path path = fs.getPath("C:\\Java\\Chapter.13\\Data.txt"); 


Recall that the backslash is used as part of an escape sequence in Java. (For example, '\n' 
represents a newline character.) So, to enter a backslash as a path delimiter within a string, 
you must type two backslashes to indicate a single backslash. An alternative is to use the 
FileSystem method getSeparator(). This method returns the correct separator for the 
current operating system. For example, you can create a Path that is identical to the previous 
one using a statement such as the following: 


Path filePath = fs.getPath("C:" + fs.getSeparator() + "Java" + 
fs.getSeparator() + "Chapter.13" + fs.getSeparator() + 
"Data.txt"); 


Another way to create a Path is to use the Paths class (notice the name ends with s). The 
Paths class is a helper class that eliminates the need to create a FileSystem object. The Paths 
class get) method calls the getPath() method of the default file system without requiring 
you to instantiate a FileSystem object. You can create a Path object by using the following 
statement: 


Path filePath = Paths.get("C:\\Java\\Chapter.13\\SampleFile.txt"); 


After the Path is created, you use its identifier (in this case, FilePath) to refer to the file and 
perform operations on it. C:\Java\Chapter.13\SampleFile.txt is the full name of a stored file 
when the operating system refers to it, but the path is known as filePath within the 
application. The idea of a file having one name when referenced by the operating system and a 
different name within an application is similar to the way a student known as “Arthur” in 
school might be “Junior” at home. When an application declares a path and you want to use 
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the application with a different file, you would change only the String passed to the 
instantiating method. 


Every Path is either absolute or relative. An absolute path is a complete path; it does not need 
any other information to locate a file on a system. A relative path depends on other path 
information. A full path such as C:\Java\Chapter.13\SampleFile.txt is an absolute path. 

A simple path such as SampleFile.txt is relative. When you work with a path that contains 
only a filename, the file is assumed to be in the same folder as the program using it. Similarly, 
when you refer to a relative path such as Chapter.13\SampleFile.txt (without the drive letter 
or the top-level Java folder), the Chapter.13 folder is assumed to be a subfolder of the current 
directory, and SampleFile.txt is assumed to be within the folder. 


679 








consists of the drive letter followed by a colon. For UNIX platforms, the prefix of an absolute pathname is 


For Microsoft Windows platforms, the prefix of an absolute pathname that contains a disk-drive specifier 
Y always a forward slash. 


Retrieving Information About a Path 


Table 13-1 summarizes several useful Path methods. As you have learned with other 
classes, the toString() method is overridden from the Object class; it returns a String 
representation of the Path. Basically, this is the list of path elements separated by copies 
of the default separator for the operating system. The getFileName() method returns 
the last element in a list of pathnames; frequently this is a filename, but it might be a 
folder name. 





Method Description 
String toString() Returns the String representation of the Path, eliminating double 
backslashes 


Path getFileName() Returns the file or directory denoted by this Path; this is the last item in 
the sequence of name elements 


int getNameCount() Returns the number of name elements in the Path 


Path getName(int) Returns the name in the position of the Path specified by the integer 
parameter 


Wel) S) Selected Path class methods 


A Path’s elements are accessed using an index. The top-level element in the directory 
structure is located at index 0; the lowest element in the structure is accessed by the 
getName() method and has an index that is one less than the number of items on the list. You 
can use the getNameCount() method to retrieve the number of names in the list and the 
getName(int) method to retrieve the name in the position specified by the argument. 
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Figure 13-1 shows a demonstration program that creates a Path and uses some of the 
methods in Table 13-1. Figure 13-2 shows the output. 


import java.nio.file.*; 





680 public class PathDemo 
{ 
public static void main(String[] args) 
{ 
Path filePath = 
Paths.getC"C:\\Java\\Chapter.13\\Data.txt"); 
int count = filePath.getNameCountQ) ; 
System.out.printInC"Path is " + filePath.toStringQ); 
System.out.printInC"File name is " + filePath.getFileName()); 
System.out.printIn("There are " + count + 
"elements in the file path"); 
forCint x = 0; x < count; ++x) 
System.out.printIn(C"Element "+x +" is "+ 
FilePath. getName(x)); 
} 


Figure 13-1 The PathDemo class 





a 
fay Command Prompt 


C:\Java>java PathDemo 

Path is C:\Java\Chapter.13\Data.txt 
mFile name is Data.txt 

There are 3 elements in the file path 
Element @ is Java 


Element 1 is Chapter.13 
| 
WElement 2 is Data.txt 


C:\Java> 











Figure 13-2 Output of the PathDemo application 


Converting a Relative Path to an Absolute One 


The toAbsolutePath() method converts a relative path to an absolute path. For example, 
Figure 13-3 shows a program that asks a user for a filename and converts it to an absolute 
path, if necessary. 
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import java.util.Scanner; 
import java.nio.file.*; 
public class PathDemo2 

{ 


public static void main(String[] args) 
{ 681 
String name; 








Scanner keyboard = new Scanner(System. in); 
System.out.printC"Enter a file name >> "); 

name = keyboard.nextLineQ) ; 

Path inputPath = Paths.get(name) ; 

Path fullPath = inputPath.toAbsolutePath() ; 
System.out.printInC"Full path is "+ fullPath.toStringQ); 





Figure 13-3 The PathDemo2 class 


When the PathDemo2 program executes, the entered filename might represent only a relative 
path. If the input represents an absolute Path, the program does not modify the input, but if 
the input represents a relative Path, this program then creates an absolute path by assigning 
the file to the current directory. Figure 13-4 shows a typical program execution. 





a 
fay Command Prompt 


C:\Java>java PathDemo2 
Benter a file name >> Memo.txt 
Full path is C:\Java\Memo.txt 


C=\Java> 








Figure 13-4 Output of the PathDemo2 program 


Checking File Accessibility 


To verify that a file exists and that the program can access it as needed, you can use the 
checkAccess() method. The following import statement allows you to access constants that 
can be used as arguments to the method: 


import static java.nio.file.AccessMode.*; 


Assuming that you have declared a Path named filePath, the syntax you use with 
checkAccess() is as follows: 


filePath.getFileSystemQ .provider() .checkAccess(); 
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You can use any of the following as arguments to the checkAccess() method: 


e No argument—Checks that the file exists; as an alternative, you can substitute the 
Files.exists() method and pass it a Path argument. 


e READ—Checks that the file exists and that the program has permission to read the file 
682 





e WRITE—Checks that the file exists and that the program has permission to write to the file 


e EXECUTE—Checks that the file exists and that the program has permission to execute 
the file 


import and the name of the package being imported. This feature allows you to use static constants 
without their class name. For example, if you remove static from the import statement for 
java.nio.file.AccessMode, you must refer to the READ constant by its full name as 
AccessMode. READ; when you use static, you can refer to it just as READ. 


Q Java's static import feature takes effect when you place the keyword static between 


You can use multiple arguments to the checkAccess() method, separated by commas. 

If the file cannot be accessed as indicated in the method call, an IOException is thrown. 
(Notice in Figure 13-5 that the java.io. IOException package must be imported because an 
IOException might be instantiated and thrown.) Figure 13-5 shows an application that 
declares a Path and checks whether the file can both be read and executed. Figure 13-6 shows 
the output. 


import java.nio.file.*; 
import static java.nio.file.AccessMode. *; 
import java.io.IOException; 
public class PathDemo3 
{ 
public static void main(String[] args) 
{ 
Path filePath = 
Paths.get("C:\\Java\\Chapter.13\\Data. txt"); 
System.out.printInC("Path is " + filePath.toStringQ); 
try 
{ 


FilePath. getFileSystemQ .provider() .checkAccess(fi lePath, READ, EXECUTE) ; 
System.out.printInC"File can be read and executed"); 


} 
catchCIOException e) 
d 
System.out.printIn 
C"File cannot be used for this application"); 





Figure 13-5 The PathDemo3 class 
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r = 
worsen | 


C:\Java>java PathDemo3 
Path is C:\Java\Chapter.13\Data.txt 
File can be read and executed 





C:\Java>_ 











Figure 13-6 Output of the PathDemo3 application 


statement. This type of program bug is called a TOCTTOU bug (pronounced tock too}—it happens when 


A program might find a file usable, but then the file might become unusable before it is actually used in a later 
GD changes occur from Time Of Check To Time Of Use. 


Deleting a Path 


The Files class delete() method accepts a Path parameter and deletes the last element (file 
or directory) in a path or throws an exception if the deletion fails. For example: 


e Ifyou try to delete a file that does not exist, a NoSuchFi leException is thrown. 


e A directory cannot be deleted unless it is empty. If you attempt to delete a directory that 
contains files, a DirectoryNotEmptyException is thrown. 


e Ifyou try to delete a file but you don’t have permission, a SecurityException is thrown. 
e Other input/output errors cause an IOException. 


Figure 13-7 shows a program that displays an appropriate message in each of the preceding 
scenarios after attempting to delete a file. 


import java.nio.file.*; 
import java.io.IOException; 
public class PathDemo4 

{ 


public static void main(String[] args) 
{ 
Path filePath = 
Paths.get("C:\\Java\\Chapter.13\\Data.txt"); 
try 
{ 
Files.delete(filePath) 
System.out.printInC"File or directory is deleted"); 








Figure 13-7 The PathDemo4 class (continues) 
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(continued) 


catch (NoSuchFileException e) 
{ 


} 
catch (DirectoryNotEmptyException e) 
{ 


} 


catch (SecurityException e) 


{ 


} 
catch (IOException e) 
{ 


System.out.printIn("No such file or directory"); 


System.out.printInC"Directory is not empty"); 


System.out.printInC"No permission to delete"); 


System.out.printInC"I0O exception") ; 





Figure 13-7 The PathDemo4 class 


The Files class deleteIfExists() method also can be used to delete a file, but if the file does 
not exist, no exception is thrown. 


Determining File Attributes 


You can use the readAttributes() method of the Files class to retrieve useful information about 
a file. The method takes two arguments—a Path object and BasicFileAttributes.class—and 
returns an instance of the BasicFileAttributes class. You might create an instance with a 
statement such as the following: 


BasicFileAttributes attr = 
Files.readAttributes(filePath, BasicFileAttributes.class); 


After you have created a BasicFileAttributes object, you can use a number 

of methods for retrieving information about a file. For example, the sizeQ 
method returns the size of a file in bytes. Methods such as creationTime() and 
lastModifiedTime() return important file times. Figure 13-8 contains a program 
that uses these methods. 
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import java.nio.file.*; 

import java.nio.file.attribute.*; 

import java.io.IOException; 

public class PathDemo5 

{ 685 
public static void main(String[] args) 


{ 








Path filePath = 
Paths.getC"C:\\Java\\Chapter.13\\Data.txt"); 
try 
{ 
BasicFileAttributes attr = 
Files.readAttributes(filePath, BasicFileAttributes.class); 
System.out.printInC"Creation time " + attr.creationTime()) ; 
System.out.printInC"Last modified time " + 
attr. lastModifiedTimeQ); 
System.out.printInC"Size " + attr.sizeQ); 
} 
catch(IOException e) 
{ 
System.out.printInC"I0O Exception") ; 








Figure 13-8 The PathDemoS class 


The time methods in the PathDemo5 program each return a FileTime object that is converted to a 
String in the printIn© method calls. FileTime objects are represented in the following format: 


yyyy-mm-ddThh:mm:ss 


In a FileTime object, the four-digit year is followed by the two-digit month and two-digit day. 
Following a T for Time, the hour, minute, and seconds (including fractions of a second) are 
separated by colons. You can see from the output in Figure 13-9 that the file was created in 
August 2010 and last modified in March 2012. 


r 


C:\Java>java PathDemoS 
sCreation time 2616-08-17T22:55:51.335672Z 
Last modified time 2612-63-16T18 -67:22.978552Z2 





Size 15 


C:\Java> 














Figure 13-9 Output of the PathDemo5 program 
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Frequently, you don’t care about a file’s exact FileTime value, but you are interested 

in comparing two files. You can use the compareTo() method to determine the time 

relationships between files. For example, Figure 13-10 shows how you might compare the 

creation times of two files. As shown in the shaded statement, the compareTo() method 

returns a value of less than 0 if the first FileTime comes before the argument’s FileTime. 

686 The method returns a value of greater than 0 if the first FileTime is later than the argument’s, 
and it returns 0 if the FileTime values are the same. 





import java.nio.file.*; 
import java.nio.file.attribute.*; 
import java.io.IOException; 
public class PathDemo6 
{ 
public static void main(String[] args) 
{ 
Path filel = 
Paths.get("C:\\Java\\Chapter.13\\Data.txt"); 
Path file2 = 
Paths. getC"C:\\Java\\Chapter.13\\Data2.txt"); 
try 
{ 
BasicFileAttributes attrl = 
Files.readAttributes(filel, BasicFileAttributes.class) ; 
BasicFileAttributes attr2 = 
Files.readAttributes(file2, BasicFileAttributes.class); 
FileTime timel = attri1.creationTime(); 
FileTime time2 = attr2.creationTime() ; 
System.out.printIn("filel's creation time is: 
System.out.printIn("file2's creation time is: 
if(timel.compareTo(time2) < 0) 
System.out.printIn("filel was created before file2"); 
else 
if(timel.compareTo(time2) > 0) 
System.out.printInC"filel was created after file2"); 
else 
System.out.printIn 
C"filel and file2 were created at the same time"); 


+ timel); 
+ time2); 


} 
catch(IOException e) 


{ 


System.out.printInC"IO Exception") ; 





Figure 13-10 The PathDemo6 class 
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Figure 13-11 shows the output of the application in Figure 13-10. The file named filel was 
created in August 2010, and file2 was created in October 2011, so the program correctly 
determines that filel was created first. 


o 
fy Command promt ii 


C:\Java>java PathDemo6 

filei’s creation time is: 2616-@8-17T22:55:51.33567Z 
file2’s ation time is: 2611-10-25T26:36:48 .421483Z 
filei was created before file2 
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C:\Java>_ 











Figure 13-11 Output of the PathDemo6 program 


systems and POSIX file attributes used on systems such as UNIX. For example, DOS files might be hidden or 
read only and UNIX files might have a group owner. For more details on specialized file attributes, visit the 
Java Web site. 


Q Besides BasicFileAttributes, Java supports specialized classes for DOS file attributes used on DOS 


a) Watch the video Paths and Attributes. 


Using the Path and Files Classes 


1. Java's Path class is used to create objects that contain information to specify 
the location of files or directories. 


2. Arelative path is a complete path; it does not need any other information to 
locate a file on a system. 


3. You can use the readAttributes() method of the Files class to retrieve 
information about a file, such as its size and when it was created. 
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File Organization, Streams, and Buffers 


Most businesses generate and use large quantities of data every day. You can store data in 

variables within a program, but such storage is temporary. When the application ends, the 

variables no longer exist and the data values are lost. Variables are stored in the computer's 
688 main or primary memory (RAM). When you need to retain data for any significant amount 
of time, you must save the data on a permanent, secondary storage device, such as a disk. 





Businesses organize data in a hierarchy, as shown in Figure 13-12. The smallest useful piece of data 
to most users is the character. A character can be any letter, number, or other special symbol 
(such as a punctuation mark) that makes up data. Characters are made up of bits (the zeros and 
ones that represent computer circuitry), but people who use data typically do not care whether the 
internal representation for an A is 01000001 or 10111110. Rather, they are concerned with the 
meaning of A—for example, it might represent a grade in a course, a person’s initial, or a company 
code. In computer terminology, a character can be any group of bits, and it does not necessarily 
represent a letter or number; for example, some “characters” produce a sound or control the 
display. Also, characters are not necessarily created with a single keystroke; for example, escape 
sequences are used to create the '\n' character, which starts a new line, and '\\', which 
represents a single backslash. Sometimes, you can think of a character as a unit of information 
instead of data with a particular appearance. For example, the mathematical character pi (1) and 
the Greek letter pi look the same, but have two different Unicode values. 


Employee file 


Records: Andrews record Brown record Collins record 


Fields: 


Characters: 











Figure 13-12 Data hierarchy 


When businesses use data, they group characters into fields. A field is a group of characters 
that has some meaning. For example, the characters T, 0, and m might represent your first 
name. Other data fields might represent items such as last name, Social Security number, zip 
code, and salary. 


Fields are grouped together to form records. A record is a collection of fields that contain 
data about an entity. For example, a person’s first and last names, Social Security number, zip 
code, and salary represent that person’s record. When programming in Java, you have created 
many classes, such as an Employee class or a Student class. You can think of the data typically 
stored in each of these classes as a record. These classes contain individual variables that 
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represent data fields. A business’s data records usually represent a person, item, sales 
transaction, or some other concrete object or event. 


Records are grouped to create files. Data files consist of related records, such as a company’s 
personnel file that contains one record for each company employee. Some files have only a few 
records; perhaps your professor maintains a file for your class with 25 records—one record for 
each student. Other files contain thousands or even millions of records. For example, a large 
insurance company maintains a file of policyholders, and a mail-order catalog company 
maintains a file of available items. A data file can be used as a sequential access file when each 
record is accessed one after another in the order in which it was stored. Most frequently, each 
record is stored in order based on the value in some field; for example, employees might be 
stored in Social Security number order, or inventory items might be stored in item number 
order. When records are not used in sequence, the file is used as a random access file. You will 
learn more about random access files later in this chapter. 
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When records are stored in a data file, their fields can be organized one to a line, or a 
character can be used to separate them. A file of comma-separated values (CSV) is one in 
which each value in a record is separated from the next by a comma; CSV is a widely used 
format for files used in all sorts of applications, including databases and spreadsheets. Later in 
this chapter, you will see examples of CSV files. 


Before an application can use a data file, it must open the file. A Java application opens a file by 
creating an object and associating a stream of bytes with it. Similarly, when you finish using a file, 
the program should close the file—that is, make it no longer available to your application. If you 
fail to close an input file—a file from which you are reading data—there usually are no serious 
consequences; the data still exists in the file. However, if you fail to close an output file—a file to 
which you are writing data—the data might become inaccessible. You should always close every 
file you open, and usually you should close the file as soon as you no longer need it. When you 
leave a file open for no reason, you use computer resources, and your computer’s performance 
suffers. Also, particularly within a network, another program might be waiting to use the file. 


Whereas people view a file as a series of records, with each record containing data fields, Java 
does not automatically attribute such meaning to a file’s contents. Instead, Java simply views a 
file as a series of bytes. When you perform an input operation in an application, you can picture 
bytes flowing into your program from an input device through a stream, which functions as a 
pipeline or channel. When you perform output, some bytes flow out of your application through 
another stream to an output device, as shown in Figure 13-13. A stream is an object, and like all 
objects, streams have data and methods. The methods allow you to perform actions such as 
opening, closing, reading, and writing. 


Application 
Input ——> 
Output —» 


Figure 13-13 File streams 
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Most streams flow in only one direction; each stream is either an input or output stream. (Random 
access files use streams that flow in two directions. You will use a random access file later in this 
chapter.) You might open several streams at once within an application. For example, an 
application that reads a data disk and separates valid records from invalid ones might require three 
streams. The data arrives via an input stream; one output stream writes some records to a file of 
690 valid records, and another output stream writes other records to a file of invalid records. 





Input and output operations are usually the slowest in any computerized system 
because of limitations imposed by the hardware. For that reason, professional programs 
often employ buffers. A buffer is a memory location where bytes are held after they are 
logically output but before they are sent to the output device. Using a buffer to 
accumulate input or output before issuing the actual IO command improves program 
performance. When you use an output buffer, you sometimes flush it before closing it. 
Flushing clears any bytes that have been sent to a buffer for output but have not yet 
been output to a hardware device. 


ee 
su Watch the video File Organization, Streams, and Buffers. 


File Organization, Streams, and Buffers 


1. A field is a group of characters that has some meaning; a record is a collection 
of fields. 


2. A data file is used as a sequential access file when the first field for each record 
is stored first in a file, the second field for each record is stored next, and so on. 


3. Java views files as a series of bytes that flow into and out of your applications 
through a stream. 
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Using Java’s lO Classes 


Figure 13-14 shows a partial hierarchical relationship of some of the classes Java uses for input 
and output (IO) operations; it shows that InputStream, OutputStream, and Reader are 
subclasses of the Object class. All three of these classes are abstract. As you learned in 
Chapter 11, abstract classes contain methods that must be overridden in their child classes. 
The figure also shows the major IO child classes that you will study in this chapter. The 
capabilities of these classes are summarized in Table 13-2. 
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Object 
| 


+--InputStream 


| 
+--FileInputStream 
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+--FilterInputStream 


+--BufferedInputStream 








-OutputStream 


+--FilterOutputStream 


+--BufferedOutputStream 


+--PrintStream 
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| 

| 

| 

| 

pe 

| 
| +--FileOutputStream 
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| 

| 

| 

| 

| 

rae 


+--BufferedReader 


+--Bufferedwriter 





Figure 13-14 Relationship of selected IO classes 





Class Description 

InputStream Abstract class that contains methods for performing input 
FileInputStream Child of InputStream that provides the capability to read from disk files 
BufferedInputStream Child of Fi lterInputStream, which is a child of InputStream; 


Buf feredInputStream handles input from a system’s standard 
(or default) input device, usually the keyboard 


OutputStream Abstract class that contains methods for performing output 
FileOutputStream Child of OutputStream that allows you to write to disk files 


BufferedOutputStream Child of Fil terOutputStream, which is a child of OutputStream; 
Buf feredOutputStream handles input from a system's standard 
(or default) output device, usually the monitor 


PrintStream Child of Fil terOutputStream, which is a child of OutputStream; 
System.out Is a PrintStream object 


WE) NE) Description of selected classes used for input and output (continues) 
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(continued) 
Class Description 
Reader Abstract class for reading character streams; the only methods that a 
subclass must implement are read(char[], int, int) andcloseQ 
BufferedReader Reads text from a character-input stream, buffering characters to 
provide for efficient reading of characters, arrays, and lines 
BufferedWriter Writes text to a character-output stream, buffering characters to 


provide for the efficient writing of characters, arrays, and lines 


We\)(S Description of selected classes used for input and output 


As its name implies, the OutputStream class can be used to produce output. Table 13-3 shows 
some of the class’s common methods. You can use OutputStream to write all or part of an array 
of bytes. When you finish using an OutputStream, you usually want to flush and close it. 


OutputStream Method Description 





void close() Closes the output stream and releases any system resources 
associated with the stream 


void flushQO Flushes the output stream; if any bytes are buffered, they will be written 
void write(byte[] b) Writes all the bytes to the output stream from the specified byte array 


void write(byte[] b, Writes bytes to the output stream from the specified byte array starting 
int off, int len) at offset position of f for a length of len characters 


We) CEE) Selected OutputStream methods 


Java’s System class contains a PrintStream object named System.out; you have used this object 
extensively in the book, along with its print and printInQ methods. Besides System. out, the 
System class defines a PrintStream object named System.err. The output from System.err 
and System. out can go to the same device; in fact, System.err and System. out are both 
directed by default to the command line on the monitor. The difference is that System.err is 
usually reserved for error messages, and System. out is reserved for valid output. You can direct 
either System.err or System. out to a new location, such as a disk file or printer. For example, 
you might want to keep a hard copy (printed) log of the error messages generated by a program 
but direct the standard output to a disk file. 


Although you usually have no need to do so, you can create your own OutputStream object 
and assign System. out to it. Figure 13-15 shows how this works. The application declares 
a String of letter grades allowed in a course. Then, the getBytes() method converts the 
String to an array of bytes. An OutputStream object is declared, and System. out is 
assigned to the OutputStream reference in a try block. The write() method accepts the 
byte array and sends it to the output device, and then the output stream is flushed and 
closed. Figure 13-16 shows the execution. 
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import java.io.*; 
public class ScreenOut 
{ 
public static void main(String[] args) 
{ 
String s = "ABCDF"; 
byte[] data = s.getBytesQ(); 
OutputStream output = null; 
try 
{ 
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output = System.out; 
output.write(data) ; 
output. flushQ ; 
output.close(); 

} 

catch(Exception e) 


{ 


System.out.printIn("Message: 


+e); 





Figure 13-15 The ScreenOut class 





i 
[8 Command Prompt =" a 





C:\Java>java ScreenOut 
ABCDF 
C:\Java> 





Figure 13-16 Output of the ScreenOut program 


Writing to a File 


The output in Figure 13-16 is not very impressive. Before you knew about streams, you 
wrote applications that displayed a string on the monitor by using the automatically created 
System.out object, so the application in Figure 13-15 might seem to contain a lot of 
unnecessary work at first. However, other output devices can be assigned to OutputStream 
references, allowing your applications to save data to them. 


Instead of assigning the standard output device to OutputStream, you can assign a file. 

To accomplish this, you can construct a BufferedOutputStream object and assign it to the 
OutputStream. If you want to change an application’s output device, you don’t have to 

modify the application except to assign a new object to the OutputStream; the rest of the logic 
remains the same. Java lets you assign a file to a Stream object so that screen output and file 
output work in exactly the same manner. 
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You can create a writeable file by using the Files class newOutputStream() method. You pass a 
Path and a StandardOpenOption argument to this method. The method creates a file if it does 
not already exist, opens the file for writing, and returns an OutputStream that can be used to 
write bytes to the file. Table 13-4 shows the StandardOpenOption arguments you can use as the 
second argument to the newOutputStream() method. If you do not specify any options and the 
file does not exist, a new file is created. If the file exists, it is truncated. In other words, specifying 
no option is the same as specifying both CREATE and TRUNCATE_EXISTING. 


StandardOpenOption Description 
WRITE Opens the file for writing 





APPEND Appends new data to the end of the file; use this option with WRITE or CREATE 


TRUNCATE_EXISTING _ Truncates the existing file to 0 bytes so the file contents are replaced; use 
this option with the WRITE option 


CREATE_NEW Creates a new file only if it does not exist; throws an exception if the file 
already exists 

CREATE Opens the file if it exists or creates a new file if it does not 

DELETE_ON_CLOSE Deletes the file when the stream is closed; used most often for temporary 


files that exist only for the duration of the program 


VE) Selected StandardOpenOption constants 


Figure 13-17 shows an application that writes a String of bytes to a file. The only differences 
from the preceding ScreenOut class are shaded in the figure and summarized here: 


e Additional import statements are used. 
e The class name is changed. 
e A Path is declared for a Grades.txt file. 


e Instead of assigning System. out to the OutputStream reference, a BufferedOutputStream 
object is assigned. 


import java.nio.file.*; 
import java.io.*; 
import static java.nio.file.StandardOpenOption.*; 


public class FileOut 
{ 
public static void main(String[] args) 
{ 
Path file = 
Paths.get("C:\\Java\\Chapter.13\\Grades.txt"); 
String s = "ABCDF"; 





Figure 13-17 The FileOut class (continues) 
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(continued) 


byte[] data = s.getBytes(Q); 
OutputStream output = null; 
try 

{ 


output = new 695 
BufferedOutputStream(Files.newOutputStream(file, CREATE)); 

output .write(data) ; 

output. flush(); 








output.close(); 
} 
catch(Exception e) 


t 


System.out.printIn("Message: + @); 





Figure 13-17 The FileOut class 


When the FileOut program executes, no output appears on the monitor, but a file is created. 
Figure 13-18 shows the file when it is opened in Notepad. 





rn 
i} - pa" 
/| Grades Notepad 


File Edit Format View Help 
|ABCDF 








Figure 13-18 Contents of the Grades.txt file created by the Fi leOut program 


Reading from a File 


You use an InputStream like you use an OutputStream. If you want, you can create an 
InputStream, assign System. in to it, and use the class’s read() method with the created 
object to retrieve keyboard input. Usually, however, it is more efficient to use the Scanner 
class for keyboard input and to use the InputStream class to input data that has been stored 
in a file. 


To open a file for reading, you can use the Files class newInputStream() method. This 
method accepts a Path parameter and returns a stream that can read bytes from a file. 
Figure 13-19 shows a ReadFile class that reads from the Grades.txt file created earlier. 
The Path is declared, an InputStream is declared using the Path, and, in the first shaded 
statement in the figure, a stream is assigned to the InputStream reference. 
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import java.nio.file.*; 

import java.io.*; 

public class ReadFile 

{ 

696 public static void main(String[] args) 
{ 





Path file = Paths.get("C:\\Java\\Chapter.13\\Grades.txt"); 
InputStream input = null; 
try 
{ 
input = Files.newInputStream(fi le); 
BufferedReader reader = new 


BufferedReader(new InputStreamReader (input) ) ; 
String s = null; 
s = reader.readLineQ; 
System.out.printIn(s); 
input.closeQ; 


} 
catch (IOException e) 


{ 
System.out.printIn(e); 





Figure 13-19 The ReadFi1e class 


If you needed to read multiple lines from the file in the program in Figure 13-19, you could use a loop such as 
Y the following: 


while(s = reader.readLine() != null) 
System.out.printIn(s); 


This loop continuously reads and displays lines from the file until the readLine() method returns nu11, 
indicating that no more data is available. 


In the second shaded statement in the ReadFi1e class, a BufferedReader is declared. 

A BufferedReader reads a line of text from a character-input stream, buffering characters so that 
reading is more efficient. Figure 13-20 shows the ReadFi le program’s execution. The readLineQ 
method gets the single line of text from the Grades.txt file, and then the line is displayed. 





i 





Cc dP b= Lo 
fay Command Prompt 


C:\Java>java ReadFile 
ABCDF 


C:z\Java> 





Figure 13-20 Execution of the ReadFile program 
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When you use the BufferedReader class, you must import the java.io package into your 
program. Table 13-5 shows some useful BufferedReader methods. 











BufferedReader Method Description 697 
close() Closes the stream and any resources associated with it 
read() Reads a single character 
read(char[] buffer, Reads characters into a portion of an array from position of f for 
int off, int len) len characters 
readLineQ) Reads a line of text 
skipClong n) Skips the specified number of characters 


Vel) E Selected BufferedReader methods 


Using Java’s IO Classes 


1. Java’s InputStream, OutputStream, and Reader Classes are used for handling 
input and output. 


2. You can create your own OutputStream object, assign System. out to it, 
and use it for writing output to the screen, or you can use the Files class 
newOutputStream() method to create a file and open it for writing. 


3. To open a file for reading, you can use the newOutputStream() method to get a 
stream that can read bytes from a file. 
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Creating and Using Sequential Data Files 


Frequently, you want to save more than a single String to a file. For example, you might 
have a data file of personnel records that includes an ID number, name, and pay rate for 
each employee in your organization. Figure 13-21 shows a program that reads employee 
ID numbers, names, and pay rates from the keyboard and sends them to a comma- 
separated file. 
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import java.nio.file.*; 

import java.io.*; 

import static java.nio.file.StandardOpenOption.*; 
import java.util.Scanner; 

698 public class WriteEmployeeFile 

{ 





public static void main(String[] args) 
{ 
Scanner input = new Scanner(System. in); 
Path file = 
Paths.getC"C: \\Java\\Chapter.13\\Employees.txt"); 
String s= ""; 
String delimiter = ","; 
int id; 
String name; 
double payRate; 
final int QUIT = 999; 
try 
{ 
OutputStream output = new 
BufferedOutputStream(Files.newOutputStream(file, CREATE)); 
BufferedWriter writer = new 
BufferedWriter(new OutputStreamWriter (output) ) ; 
System.out.printC"Enter employee ID number >> "); 
id = input.nextIntQ; 
whileCid != QUIT) 
{ 
System.out.print("Enter name for employee #" + 
id+" >>"); 
input.nextLineQ); 
name = input.nextLineQ ; 
System.out.printC"Enter pay rate >> "); 
payRate = input.nextDouble(); 
s = id + delimiter + name + delimiter + payRate; 
writer.write(s, 0, s.lengthQ); 
writer.newLineQ ; 
System.out.printC"Enter next ID number or " + 
QUIT + " to quit >> "); 
id = input.nextIntQ; 
} 
writer.close(); 
} 
catch(Exception e) 


dl 


System.out.printIn("Message: 


+ @); 





Figure 13-21 The WriteEmployeeFi le class 
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Chapter 2 that this extra call is necessary to consume the newline character that remains in the input buffer 


In Figure 13-21, notice the extra nextLine() call after the employee’s ID number is entered. Recall from 
Y after the ID number is accepted. 


The first shaded statement in the WriteEmployeeFile program creates a BufferedwWriter 
named writer. The Bufferedwriter class is the counterpart to BufferedReader. It writes 
text to an output stream, buffering the characters. The class has three overloaded write() 
methods that provide for efficient writing of characters, arrays, and strings, respectively. 
Table 13-6 contains all the methods defined in the Bufferedwriter class. 
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Bufferedwriter Method Description 

closeQ) Closes the stream, flushing it first 

FlushQ) Flushes the stream 

newline(Q) Writes a line separator 

write(String s, int off, int len) Writes a String from position of f for length Ten 


write(char[] array, int off, int len) Writes a character array from position of f for 
length Ten 


writeCint c) Writes a single character 


WECM EE) Bufferedwriter methods 


In the WriteEmployeeFile program, Strings of employee data are constructed within a loop 
that executes while the user does not enter the QUIT value. When a String is complete—that 
is, when it contains an ID number, name, and pay rate separated with commas—the String is 
sent to writer in the second shaded statement in the class. The write() method accepts the 
String from position 0 for its entire length. 


After the String is written, the system’s newline character is also written. Although a data file 
would not require a newline character after each record (each new record could be separated 
with a comma or any other unique character that was not needed as part of the data), placing 
each record on a new line makes the output file easier for a person to read and interpret. 
Because not all platforms use '\n' to separate lines, the Bufferedwriter class contains a 
newLine() method that uses the current platform’s line separator. Alternatively, you could 
write the value of System. getProperty("line.separator "). This method call returns the 
default line separator for a system; the same separator is supplied either way because the 
newLine() method actually calls the System. getProperty( method for you. 


Any of the input or output methods in the WriteEmployeeFile program might throw an 
exception, so all the relevant code in the class is placed in a try block. Figure 13-22 shows a 
typical program execution, and Figure 13-23 shows the output file when it is opened in 
Notepad. 
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[ fay Command Prompt iii. 


C:\Java>java WriteEmployeeFile 
* employee ID number >> 145 
"name for employee #145 >> Harris 
*“ pay Pate >> 12.55 
700 * next ID number or 999 to quit >> 289 
“name for employee #289 >> Gorman 
*“ pay rate >> 15.65 
* next ID number or ?99 to quit >> 364 
* name for employee #364 >> Parker 
* pay Pate >> 19.95 
* next ID number or ?99 to quit >> 999 


















Figure 13-22 Typical execution of the WriteEmployeeFi le program 





= 
~| Employees - Not... 







File Edit Format View Help 


(L45,Harris,12.55 ; 
289,Gorman,15.65 
364,Parker ,19.95 











Figure 13-23 Output file following the program execution in Figure 13-22 


Figure 13-24 shows a program that reads the Employees.txt file created by the 
WriteEmployeeFi le program. The program declares an InputStream for the file, then creates a 
BufferedReader using the InputStream. The first line is read into a String; as long as the 
readLine() method does not return nu11, the String is displayed and a new line is read. 





import java.nio.file.*; 
import java.io.*; 
public class ReadEmployeeFile 


{ 
public static void main(String[] args) 
{ 
Path file = 
Paths.getC"C:\\Java\\Chapter.13\\Employees.txt"); 
String s = ""; 
try 


Figure 13-24 The ReadEmployeeFi1e class (continues) 
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(continued) 


InputStream input = new 
BufferedInputStream(Files.newInputStream(file)); 
BufferedReader reader = new 
BufferedReader(new InputStreamReader (input) ) ; 701 
s = reader.readLineQ; 
whilecs != null) 
{ 








System.out.printIn(s) ; 


s = reader.readLineQ; 


reader.close(); 
} 
catch(Exception e) 
{ 


System.out.printIn("Message: 


+e); 





Figure 13-24 The ReadEmployeeFi le class 


Figure 13-25 shows the output of the ReadEmployeeFile program when it uses the file that 
was created during the execution in Figure 13-22. Each comma-separated String is displayed 
on its own line. 


Ge 
ws corns rot 


C:\Java>java ReadEmployeeFile 
145.Harris,.12.55 
289 ,.Gorman,15.65 





364, Parker,1?.95 


C:\Java> 














Figure 13-25 Output of the ReadEmp]oyeeFi le program 


Many applications would not want to use the file data only as a String like the 
ReadEmployeeFile program does. Figure 13-26 shows a more useful program in which 
the retrieved file Strings are split into usable fields. The String class sp1it() method 
accepts an argument that identifies the field delimiter (in this case, a comma) and 
returns an array of Strings. Each array element holds one field. Then methods such as 
parseIntQ and parseDouble() can be used to reformat the split Strings into their 
respective data types. 
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import java.nio.file.*; 

import java.io.*; 

public class ReadEmployeeFi 1le2 

{ 

702 public static void main(String[] args) 
{ 





Path file = 
Paths. getC"C:\\Java\\Chapter.13\\Employees.txt"); 
String[] array = new String[3]; 
String s=""; 
String delimiter = ","; 
int id; 
String name; 
double payRate; 
double gross; 
final double HRS_IN_WEEK = 40; 
double total = 0; 
try 
{ 
InputStream input = new 
BufferedInputStream(Fi les.newInputStream(file)); 
BufferedReader reader = new 
BufferedReader(new InputStreamReader (input) ) ; 
System.out.printinQ; 
s = reader.readLine(); 
while(s != null) 
{ 


array = s.split(delimiter); 

id = Integer.parseInt(array[0]); 

name = array[1]; 

payRate = Double.parseDouble(array[2]); 

gross = payRate * HRS_IN WEEK; 
System.out.printInC"ID#" + id + + name + 


$" + payRate + $" + gross); 
total += gross; 
s = reader.readLineQ; 
} 
reader.close(); 
} 
catch(Exception e) 
{ 
System.out.printIn("Message: 
} 
System.out.printIn(" Total gross payroll is $" + total); 


+e); 





Figure 13-26 The ReadEmployeeFi 1e2 class 
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As each record is read and split in the ReadEmployeeFi 1e2 class, its pay rate field is used to 
calculate gross pay for the employee based on a 40-hour workweek. Then the gross is 
accumulated to produce a total gross payroll that is displayed after all the data has been 
processed. Figure 13-27 shows the program’s execution. 


Gf 


C:\Java>java ReadEmployeeFile2 
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Harris $12.55 $582. 
Gorman $15.65 $626. 
Parker $19.95 $798. 
Total gross payroll is $1926. 


C:\Java> 








Figure 13-27 Execution of the ReadEmp]oyeeFi1le2 program 


Creating and Using Sequential Data Files 
1. A BufferedWriter writes text to an output stream, buffering the characters. 


2. A data file does not require a newline character after each record, but adding 
a newline makes the output file easier for a person to read and interpret. 


3. The String class sp1itQ method converts parts of a String to ints, 
doubles, and other data types. 
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Learning About Random Access Files 


The file examples in the first part of this chapter have been sequential access files, which 
means that you work with the records in sequential order from beginning to end. For 
example, in the ReadEmployeeFile programs, if you write an employee record with an ID 
number of 145, and then write a second record with an ID number of 289, the records remain 
in the original data-entry order when you retrieve them. Businesses store data in sequential 
order when they use the records for batch processing, which involves performing the same 
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tasks with many records, one after the other. For example, when a company produces 
customer bills, the records for the billing period are gathered in a batch and the bills are 
calculated and printed in sequence. It really doesn’t matter whose bill is produced first 
because none are distributed to customers until all bills in a group have been printed and 
mailed. 

704 





Besides indicating a system that works with many records, the term batch processing can refer to a system 
GY in which you issue many operating-system commands as a group. 


For many applications, sequential access is inefficient. These applications, known as real-time 
applications, require that a record be accessed immediately while a client is waiting. 

A program in which the user makes direct requests is an interactive program. For example, ifa 
customer telephones a department store with a question about a monthly bill, the customer 
service representative does not want to access every customer account in sequence. Suppose 
that the store’s database contains tens of thousands of account records to read and that the 
customer record in question is near the end of the list. It would take too long to access the 
customer’s record if all the records had to be read sequentially. Instead, customer service 
representatives require random access files—files in which records can be retrieved directly 
in any order. Random files are also called direct access files or instant access files. 


You can use Java’s FileChannel class to create your own random access files. A file channel 
object is an avenue for reading and writing a file. A file channel is seekable, meaning you can 
search for a specific file location and operations can start at any specified position. Table 13-7 
describes some FileChannel methods. 


FileChannel method Description 





FileChannel open(Path file, OpenOption... options) Opens or creates a file, returning a 
file channel to access the file 


long position() Returns the channel's file position 

FileChannel position(long newPosition) Sets the channel's file position 

int read(ByteBuffer buffer) Reads a sequence of bytes from 
the channel into the buffer 

long sizeQ) Returns the size of the channels file 

int write(ByteBuffer buffer) Writes a sequence of bytes to the 


channel from the buffer 


ECR, Selected FileChannel methods 


Several methods in Table 13-7 use a ByteBuffer object. As its name describes, a ByteBuffer 
is simply a holding place for bytes waiting to be read or written. An array of bytes can be 
wrapped, or encompassed, into a ByteBuffer using the ByteBuffer wrap() method. 
Wrapping a byte array into a buffer causes changes made to the buffer to change the array as 
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well, and causes changes made to the array to change the buffer. Creating a usable FileChannel 
for randomly writing data requires creating a ByteBuffer and several other steps: 


e You can use the Files class newByteChannel() method to get a ByteChannel for a Path. 
The newByteChannel() method accepts Path and StandardOpenOption arguments that 


specify how the file will be opened. 705 








e The ByteChannel returned by the newByteChannel() method can then be cast to a 
FileChannel using a statement similar to the following: 


FileChannel fc = (FileChannel)Files.newByteChannel (file, READ, WRITE); 


e You can create a byte array. For example, a byte array can be built from a String using 
the getBytes() method as follows: 


String s = "XYZ"; 
byte[] data = s.getBytesQ); 


e The byte array can be wrapped into a ByteBuffer as follows: 
ByteBuffer out = ByteBuffer.wrap(data) ; 


e Then the filled ByteBuffer can be written to the declared FileChannel with a statement 
such as the following: 


fc.write(out); 


e You can test whether a ByteBuffer’s contents have been used up by checking the 
hasRemaining() method. 


e After you have written the contents of a ByteBuffer, you can write the same ByteBuffer 
contents again by using the rewind() method to reposition the ByteBuffer to the 
beginning of the buffer. 


Figure 13-28 employs all these steps to declare a file and write some bytes in it randomly at 
positions 0, 22, and 12, in that order. 


import java.nio.file.*; 

import java.io.*; 

import java.nio.channels.FileChannel ; 

import java.nio.ByteBuffer; 

import static java.nio.file.StandardOpenOption.*; 
public class RandomAccessTest 


1 


public static void main(String[] args) 


{ 
Path file = 
Paths. getC"C:\\Java\\Chapter.13\\Numbers.txt"); 
String s = "XYZ"; 
byte[] data = s.getBytesQ); 
ByteBuffer out = ByteBuffer.wrap(data) ; 
FileChannel fc = null; 
try 





Figure 13-28 The RandomAccessTest Class (continues) 
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(continued) 





= (FileChannel)Files.newByteChannel (file, READ, WRITE); 
fc.position(0); 
while(Cout.hasRemaining()) 
706 fc.write(out); 
out.rewind(); 
fc.position(22); 
while(Cout.hasRemaining()) 

fc.write(out); 
out.rewind(); 
fc.position(12); 
while(Cout.hasRemaining()) 

fc.write(out); 
fc.closeQ; 





} 


catch (Exception e) 


rf 


System.out.printInC"Error message: + @); 





Figure 13-28 The RandomAccessTest class 


Figure 13-29 shows the Numbers.txt text file before and after executing the RandomAccessTest 
program in Figure 13-28. The String "XYZ" has been written at positions 0, 8, and 12. 














Figure 13-29 The Numbers.txt file before and after execution of RandomAccessTest 
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Learning About Random Access Files 


1. Businesses store data in random order when they use the records for batch 707 
processing. 








2. Realtime applications are interactive and require using random access 
data files. 


3. A FileChannel object is a seekable channel for reading and writing a file. 
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Writing Records to a Random Access Data File 


Writing characters at random text file locations, as in the RandomAccessTest program, 
is of limited value. When you store records in a file, it is often more useful to be 
able to access the eighth or 12th record rather than the eighth or 12th byte. In such a 
case, you multiply each record’s size by the position you want to access. For example, 
if you store records that are 50 bytes long, the first record is at position 0, the second 
record is at position 50, the third record is at position 100, and so on. In other words, 
you can access the mth record in a FileChannel named fc using the following 
statement: 


fc.position((n - 1) * 50); 


One approach to writing a random access file is to place records into the file based on 
a key field. A key field is the field in a record that makes the record unique from all 
others. For example, suppose you want to store employee ID numbers, last names, and 
pay rates in a random access file. In a file of employees, many records might have the 
same last name or pay rate, but each record has a unique employee ID number, so that 
field can act as the key field. 


The first step in creating the random access employee file is to create a file that holds 
default records—for example, using zeroes for the ID numbers and pay rates and 
blanks for the names. For this example, assume that each employee ID number is three 
digits; in other words, you cannot have more than 1,000 employees because the ID 
number cannot surpass 999. Figure 13-30 contains a program that creates 1,000 such 
records. 
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import java.nio.file.*; 

import java.io.*; 

import java.nio.ByteBuffer; 

import static java.nio.file.StandardOpenOption.*; 
708 public class CreateEmptyEmployeesFile 

{ 





public static void main(String[] args) 
{ 
Path file = 
Paths.get("C:\\Java\\Chapter.13\\RandomEmployees.txt") ; 
String s = "000, ,00.00" + 
System.getProperty("line.separator") ; 
byte[] data = s.getBytesQ); 
ByteBuffer buffer = ByteBuffer.wrap(data) ; 
final int NUMRECS = 1000; 
try 
{ 
OutputStream output = new 
BufferedOutputStream(Files.newOutputStream(file, CREATE)); 
Bufferedwriter writer = new 
Bufferedwriter(new OutputStreamWriter(Coutput)) ; 
forCint count = 0; count < NUMRECS; ++count) 
writer.write(s, 0, s.lengthQ); 
writer.close(); 
} 
catch(Exception e) 
{ 


+ @); 


System.out.printInC"Error message: 





Figure 13-30 The CreateEmptyEmp1]oyeesFi le class 


In the first shaded statement in Figure 13-30, a String that represents a default record is 
declared. The three-digit employee number is set to zeros, the name consists of seven blanks, 
the pay rate is 00.00, and the String ends with the system’s line separator value. A byte array 
is constructed from the String and wrapped into a buffer. Then a file is opened in CREATE 
mode and a BufferedwWriter is established. 


In the last shaded statement in Figure 13-30, a loop executes 1,000 times. Within the 
loop, the default employee string is passed to the Bufferedwriter object’s write() 
method. Figure 13-31 shows a few records from the created file when it is opened in 
Notepad. 
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File Edit Format View Help 


, 00. 
, 00. 
,00. 
00. 709 
, 00. 
,00. 
, 00. 
, 00. 

















Figure 13-31 The RandomEmployees.txt file created by the 
CreateEmptyEmp1oyeesFi le program 


The default fields in the base random access file don’t have to be zeros and blanks. For 
example, if you wanted 000 to be a legitimate employee ID number or you wanted blanks to 
represent a correct name, you could use different default values such as 999 and 
“XXXXXXX”. The only requirement is that the default records be recognizable as such. 


After you create the base default file, you can replace any of its records with data for an actual 
employee. You can locate the correct position for the new record by performing arithmetic 
with the record’s key field. 


For example, the application in Figure 13-32 creates a single employee record defined in the 
first shaded statement. The record is for employee 002 with a last name of Newmann and a pay 
rate of 12.25. In the second shaded statement, the length of this string is assigned to RECSIZE. 
(In this case, RECSIZE is 19, which includes one character for each character in the sample 
record string, including the delimiting commas, plus two bytes for the line separator value 
returned by the System. getProperty() method.) After the FileChannel is established, the 
record is written to the file at the position that begins at two times the record size. The value 2 
is hard-coded in this demonstration program because the employee’s ID number is 002. 


import java.nio.file.*; 

import java.io.*; 

import java.nio.channels.FileChannel; 

import java.nio.ByteBuffer; 

import static java.nio.file.StandardOpenOption.*; 
public class CreateOneRandomAccessRecord 


{ 


public static void main(String[] args) 


{ 


Path file = 
Paths.get("C:\\Java\\Chapter.13\\RandomEmployees.txt") ; 
String s = "002,Newmann,12.25" + 
System. getProperty("line.separator") ; 





Figure 13-32 The CreateOneRandomAccessRecord class (continues) 
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(continued) 


final int RECSIZE = s.lengthQ); 

byte[] data = s.getBytes(Q); 

ByteBuffer buffer = ByteBuffer.wrap(data) ; 
FileChannel fc = null; 

710 try 

{ 





fc = (FileChannel)Files.newByteChannel (file, READ, WRITE); 


fc.position(2 * RECSIZE); 


fc.write(buffer) ; 
fc.closeQ); 
} 
catch (Exception e) 
{ 


System.out.printInC"Error message: + @); 





Figure 13-32 The CreateOneRandomAccessRecord class 


Figure 13-33 shows the RandomEmployees.txt file contents after the 
CreateOneRandomAccessRecord program runs. The employee’s data record is correctly 
placed in the third position in the file. Later, if employees are added that have ID 
numbers 000 and 001, they can be inserted as the first two records in the file. 








,00. 
,00. 


002 ,Newmann,12. 


00. 
"00. 








Figure 13-33 The RandomEmployees.txt file after running the 
CreateOneRandomAccessRecord program 


A program that inserts one hard-coded employee record into a data file is not very 
useful. The program in Figure 13-34 accepts any number of records as user input and 
writes records to a file in a loop. As shown in the first shaded line in the figure, each 
employee’s data value is accepted from the keyboard as a String and converted to an 
integer using the parseInt() method. Then, as shown in the second shaded statement, 
the record’s desired position is computed by multiplying the ID number value by the 
record size. 
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import java.nio.file.*; 
import java.io.*; 
import java.nio.channels.FileChannel; 
import java.nio.ByteBuffer; 
import static java.nio.file.StandardOpenOption.*; 
import java.util.Scanner; 711 
public class CreateEmployeesRandomFi le 
{ 
public static void main(String[] args) 


{ 








Scanner input = new Scanner(System. in); 
Path file = 
Paths.get("C:\\Java\\Chapter.13\\RandomEmployees.txt") ; 
String s = "000, ,00.00" + 
System.getProperty("line.separator") ; 
final int RECSIZE = s.lengthQ; 
FileChannel fc = null; 
String delimiter = ","; 
String idString; 
int id; 
String name; 
String payRate; 
final String QUIT = "999"; 
try 
{ 
fc = (FileChannel)Files.newByteChannel (file, READ, WRITE); 
System.out.print("Enter employee ID number >> "); 
idString = input.nextLineQ; 
whileC! CGidString.equals(QUIT))) 
{ 
id = Integer.parseInt(idString) ; 
System.out.print("Enter name for employee #" + 
id+ ">> "); 
name = input.nextLine(); 
System.out.print("Enter pay rate >> "); 
payRate = input.nextLine(); 
s = idString + delimiter + name + delimiter + 
payRate + System.getProperty("line.separator") ; 
byte[] data = s.getBytes(); 
ByteBuffer buffer = ByteBuffer.wrap(data) ; 
fc.position(Cid * RECSIZE); 
fc.write (buffer) ; 
System.out.print("Enter next ID number or " + 
QUIT + " to quit >> "); 
idString = input.nextLineQ; 
} 
fc.closeQ; 
} 
catch (Exception e) 


{ 


System.out.printInC"Error message: " + e); 





Figure 13-34 The CreateEmployeesRandomFi le class 
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Figure 13-35 shows a typical execution of the program, and Figure 13-36 shows the resulting file. 
(This program was executed after rerunning the CreateEmptyEmployeesFile program, so all 

records started with default values, and the record created by the program shown in Figure 13-33 
is not part of the file.) In Figure 13-36, you can see that each employee record is not stored based 


on the order in which it was entered but is located in the correct spot based on its key field. 
712 








fr 























GH Command Prompt = 


C:\Java>java CreateEmployeesRandomFile 
* employee ID number >> 664 
* name for employee #4 >> Lincoln 
*“ pay rate >> 11.65 
*~ next ID number or 999 to quit >> 
* name for employee #14 >> Greeley 
*“ pay pate >> 21.15 
* next ID number or 999 to quit >> 
* name for employee #3 >> Calhoon 
*“ pay rate >> 21.45 
* next ID number or 999 to quit >> 
* name for employee #12 >> Winters 
*“ pay pate >> 17.25 
* next ID number or 999 to quit >> 














r 
_| RandomEmploye... 
File Edit Format View Help 
poo, ,00. 00 a 
ooo, ,00.00 
ooo, ,00.00 


003,Calhoon, 21.45 
004 ,Lincoln,11. 65 


ooo, ,00.00 
ooo, ,00.00 
ooo, ,00.00 
000, ,00. 00 
000, ,00.00 
000, ,00.00 
000, ,00.00 
012 ,winters,17.25 
000, ,00.00 
014 ,Greeley,21.15 
000, ,00.00 
000, ,00.00 
000, ,00.00 
ooo, ,00.00 











Figure 13-36 File created during the execution in Figure 13-35 
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Writing Records to a Random Access Data File 9) 


To keep this example brief and focused on the random access file writing, the CreateEmployeesFi le 
application makes several assumptions: 


An employee record contains only an ID number, name, and pay rate. In a real 
application, each employee would require many more data fields, such as address, phone 
number, date of hire, and so on. 


Each employee ID number is three digits. In many real applications, ID numbers would be 
longer to ensure unique values. (Three-digit numbers provide only 1,000 unique 
combinations.) 


The user will enter valid ID numbers and pay rates. In a real application, this would be a 
foolhardy assumption because users might type too many digits or type nonnumeric 
characters. However, to streamline the code and concentrate on the writing of a random 
access file, error checking for valid ID numbers and pay rates is eliminated from this 
example. 


The user will not duplicate employee ID numbers. In a real application, a key field should 
be checked against all existing key fields to ensure that a record is unique before adding it 
to a file. 


The names entered are all seven characters. This permits each record to be the same size. 
Only when record sizes are uniform can they be used to arithmetically calculate offset 
positions. In a real application, you would have to pad shorter names with spaces and 
truncate longer names to achieve a uniform size. 


Each employee’s record is placed in the random access file position that is one less 
than the employee’s ID number. In many real applications, the mathematical 
computations performed on a key field to determine file placement are more 
complicated. 


Writing Records to a Random Access Data File 


1. You can set a FileChannel’s reading position based on a key field in a record 
and the record size. 


A key field is the field in a record that holds the most sensitive information. 


A useful technique for creating random access files involves first setting up a file 
with default records in each position. 


"SJOUO [|e WO} anbiun 
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CHAPTER 13 File Input and Output 


Reading Records from a Random Access Data File 


Just because a file is created as a random access file does not mean it has to be used as one. 
You can process a random access file either sequentially or randomly. 


714 





Accessing a Random Access File Sequentially 


The RandomEmployees.txt file created in the previous section contains 1,000 records. 
However, only four of them contain valuable data. Displaying every record in the file would 
result in many irrelevant lines of output. It makes more sense to display only those records for 
which an ID number has been inserted. The application in Figure 13-37 reads through the 
1,000-record file sequentially in a while loop. The shaded statements check for valid 

ID numbers. This example assumes that no employee has a valid ID number of 000, so the 
program displays a record only when the ID is not 000. If 000 could be a valid ID number, 
then you would want to check for a name that was blank, a pay rate that was 0, or both. 
Figure 13-38 shows the application’s output—a list of the entered records, conveniently in 
ID number order, which reflects their relative positions within the file. 


import java.nio.file.*; 
import java.io.*; 
import static java.nio.file.AccessMode.*; 
public class ReadEmployeesSequential ly 
{ 
public static void main(String[] args) 
{ 
Path file = 
Paths.getC"C:\\Java\\Chapter.13\\RandomEmployees.txt") ; 
String[] array = new String[3]; 
String s= ""; 
String delimiter = ","; 
int id; 
String stringId; 
String name; 
double payRate; 
double gross; 
final double HRS_IN_WEEK = 40; 
double total = 0; 
try 
{ 
InputStream input = new 
BufferedInputStream(Files.newInputStream(file)); 
BufferedReader reader = new 
BufferedReader(new InputStreamReader (input) ); 
System.out.printiInQO; 
s = reader.readLineQ; 





Figure 13-37 The ReadEmployeesSequential ly class (continues) 
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(continued) 
whileCs != null) 
{ 
array = s.split(delimiter) ; 
stringld = array[0]; 
id = Integer.parseInt(array[0]); 715 
ifGid != 0) 
it 
name = array[1]; 
payRate = Double.parseDouble(array[2]); 
gross = payRate * HRS_IN WEEK; 
System.out.printInC"ID#" + stringId +" "4+ 
name +" $" + payRate +" $" + gross); 
total += gross; 
} 
s = reader.readLine(); 
} 
reader.close(); 
} 
catch(Exception e) 
{ 
System.out.printInC"Message: " + e); 
} 


System.out.printIn(" Total gross payroll is $" + total); 


Figure 13-37 The ReadEmployeesSequential ly class 


r 


C:\Java>java ReadEmployeesSequentially 








Calhoon $21.45 $858 .@ 
Lincoln $11.65 $466.8 
Winters $17.25 $696.8 
Greeley $21.15 $846.8 
gross payroll is $2860.86 





Figure 13-38 Output of the ReadEmployeesSequential ly application 


Accessing a Random Access File Randomly 


If you simply want to display records in order based on their key field, you do not need to 
create a random access file and waste unneeded storage. Instead, you could sort the records 
using one of the techniques you learned in Chapter 9. The benefit of using a random access 
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file is the ability to retrieve a specific record from a file directly, without reading through 
other records to locate the desired one. 


The ReadEmployeesRandomly application in Figure 13-39 allows the user to enter an 
employee’s ID number. The application calculates the correct record position in the data file 
(one less than the ID number) and positions the file pointer at the correct location to begin 
reading. The user is then prompted for an ID number, which is converted to an integer with 
the parseIntQ method. (To keep this example brief, the application does not check for a 
valid ID number, so the parseInt() method might throw an exception to the operating 
system, ending the execution of the application.) In the shaded portion of the application in 
Figure 13-39, while the user does not enter 999 to quit, the position of the sought-after record 
is calculated by multiplying the ID number by the record size and then positioning the file 
pointer at the desired location. (Again, to keep the example short, the ID number is not 
checked to ensure that it is 999 or less.) The employee record is retrieved from the data file 
and displayed, and then the user is prompted for the next desired ID number. Figure 13-40 
shows a typical execution. 
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import java.nio.file.*; 
import java.io.*; 
import java.nio.channels.FileChannel ; 
import java.nio.ByteBuffer; 
import static java.nio.file.StandardOpenOption.*; 
import java.util.Scanner; 
public class ReadEmployeesRandomly 
{ 
public static void main(String[] args) 
{ 
Scanner keyBoard = new Scanner(System.in); 
Path file = 
Paths.get("C:\\Java\\Chapter.13\\RandomEmployees.txt") ; 
String s = "000, ,00.00" + 
System.getProperty("line.separator") ; 
final int RECSIZE = s.lengthQ); 
byte[] data = s.getBytesQ); 
ByteBuffer buffer = ByteBuffer.wrap(data) ; 
FileChannel fc = null; 
String idString; 
int id; 
final String QUIT = "999"; 
try 
{ 


fc = (FileChannel)Files.newByteChannel (file, READ, WRITE); 
System.out.printC"Enter employee ID number or " + 
QUIT + " to quit >> "); 


idString = keyBoard.nextLineQ; 





Figure 13-39 The ReadEmployeesRandom|]y class (continues) 
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(continued) 


whileC!idString. equals (QUIT)) 

{ 
id = Integer.parseInt(CidString) ; 
buffer= ByteBuffer.wrap(data) ; 
fc.position(id * RECSIZE); 717 
fc.read(buffer) ; 
s = new String(data) ; 
System.out.printInC"ID #" + id + +S); 
System.out.printC"Enter employee ID number or " + 

QUIT + " to quit >> "); 

idString = keyBoard.nextLineQ ; 








" " 


} 


fc.closeQ); 


} 


catch (Exception e) 


{ 
t 


" 


System.out.printInC"Error message: +e); 


Figure 13-39 The ReadEmployeesRandomly class 


C:\Java>java ReadEmployeesRandomly 
Enter employee ID number or 999 to quit >> 612 
ID #12 612,Winters.17.25 








Enter employee ID number or 999 to quit >> 664 
ID #4 664,Lincoln,11.65 


Enter employee ID number or 999 to quit >> 999 


C:\Java> 








Figure 13-40 Typical execution of the ReadEmployeesRandomly program 


ee 
= Watch the video Random Access Data Files. 
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Reading Records from a Random Access Data File 


718 1. When a file is created as a random access file, you also must read it randomly. 





2. The benefit of using a random access file is the ability to retrieve a specific record 
from a file directly, without reading through other records to locate the desired one. 


3. When you access a record from a random access file, you usually calculate its 
position based on a key. 
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aN You Do It 


Creating Multiple Random Access Files 


In this section, you write a class that prompts the user for customer data and assigns 
the data to one of two files depending on the customer’s state of residence. This 
program assumes that Wisconsin (WI) records are assigned to an in-state file and that 
all other records are assigned to an out-of-state file. First you will create empty files to 
store the records, and then you will write the code that places each record in the 
correct file. 


1. Open a new file in your text editor, and type the following required import 
statements: 


import java.nio.file.*; 

import java.io.*; 

import java.nio.channels.FileChannel ; 

import java.nio.ByteBuffer; 

import static java.nio. file.StandardOpenOption. *; 
import java.util .Scanner; 

import java.text.*; 


2. Enter the beginning lines of the program, which include a Scanner class object 
to accept user input: 


publ ic class CreateFilesBasedOnState 

{ 
public static void main(String[] args) 
{ 


Scanner input = new Scanner (System. in); (continues) 
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Reading Records from a Random Access Data File D0 


(continued) 


3. This program uses two Path objects to hold records for in-state and out-of-state 
customers. You can use a different String value for your Paths based on your 
System and the location where you want to save your files. 719 








Path inStateFile = 

Paths. get('"'C:\\Java\\Chapter.13\\InStateCusts. txt") ; 
Path outOfStateFile = 

Paths. get("C:\\Java\\Chapter.13\\OutOfStateCusts. txt"); 


4. Build a String that can be used to format the empty files that are created before 
any actual customer data is written. Include constants for the format of the 
account number (three digits), the customer name (10 spaces), the customer’s 
state, and the customer’s balance (up to 9999.99). After defining the field 
delimiter (a comma), you can build a generic customer string by assembling the 
pieces. The record size is then calculated from the dummy record. A consistent 
record size is important so it can be used to calculate a record’s position when 
the files are accessed randomly. 


final String ID_FORMAT = "000"; 

final String NAME_FORMAT =" si 

final int NAME_LENGTH = NAME_| FORMAT. lengthQ); 

final String HOME_STATE = "WI"; 

final String BALANCE_FORMAT = "0000.00"; 

String delimiter=","; 

String s = ID_FORMAT + delimiter + NAME_FORMAT + 
delimiter + HOME_STATE + delimiter + BALANCE_FORMAT + 
System. getProperty("line.separator") ; 

final int RECSIZE = s.lengthQ; 


5. The last declarations are for two FileChannel references; String and integer 
representations of the customer’s account number; the customer's name, state, 
and balance fields; and a QUIT constant that identifies the end of data entry. 


FileChannel fcIn = nul1; 
FileChannel fcOut = null; 
String idString; 

int id; 

String name; 

String state; 

double balance; 

final String QUIT = "999"; 


6. Next, you call a method that creates the empty files into which the randomly 
placed data records can eventually be written. The method accepts the Path 
for a file and the string that defines the record format. 


createEmptyFileCinStateFile, s); 
createEmptyFile(outOfStateFile, s); 


(continues) 
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CHAPTER 13 File Input and Output 


(continued) 
7. Add closing curly braces for the main@ method and the class. Then save the file as 
CreateFilesBasedOnState.java and compile it. Correct any errors before 
proceeding. 
720 





Writing a Method to Create an Empty File 


In this section, you write the method that creates empty files using the default record 
format string. The method will create 1,000 records with an account number of 000. 


1. Just before the closing curly brace of the CreateFilesBasedOnState Class, 
insert the header and opening brace for a method that will create an empty file to 
hold random access records. The method accepts a Path argument and the 
default record String. 


public static void createEmptyFile(Path file, String s) 
{ 


2. Define a constant for the number of records to be written: 
final int NUMRECS = 1000; 


3. Inatry block, declare a new OutputStream using the method’s Path parameter. 
Then create a BufferedwWriter using the OutputStream. 


try 
{ 
OutputStream outputStr = new 
Buf feredOutputStream(Files.newOutputStream(file,CREATE)) ; 
BufferedWriter writer = new BufferedWriter (new 
OutputStreamWriter(CoutputStr)) ; 


4. Usea for loop to write 1,000 default records using the parameter String. Then 
close the Bufferedwriter, and add a closing brace for the try block. 


forCint count = 0; count < NUMRECS; ++count) 
writer.write(s, 0, s.lengthQ)); 
writer.close(); 


Hy 


5. Adda catch block to handle any Exception thrown from the try block, and add a 
closing curly brace for the method. 


catch(Exception e) 


{ 
} 


System.out.printInC"Error message: +e); 


} 


6. Save the file and compile it. Correct any errors. 
(continues) 
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(continued) 
Adding Data Entry Capability to the Program 


In these steps, you add the code that accepts data from the keyboard and writes it to 
the correct location (based on the customer's account number) within the correct file 


(based on the customer’s state). vel 








1. After the calls to the createEmptyFi1e( method, but before the method header, start 
a try block that will handle all the data entry and file writing for customer records: 


try 
{ 


2. Set up the FileChannel references for both the in-state and out-of-state files. 


fcIn = (FileChannel)Files.newByteChannel (inStateFile, CREATE, WRITE); 
fcOut = (FileChannel)Files.newByteChannel (outOfStateFile, CREATE, WRITE); 


3. Prompt the user for a customer account number, and accept it from the 
keyboard. Then start a loop that will continue as long as the user does not enter 
the QUIT value. Next, convert the entered account number to an integer so it can 
be used to calculate the file position for the entered record. In a full-blown 
application, you would add code to ensure that the account number is three 
digits, but to keep this example shorter, this program assumes that the user will 
enter valid account numbers. 


System.out.printC"Enter customer account number >> "); 
idString = input.nextLineQ); 
whileC! CidString.equals(QUIT))) 
{ 
id = Integer.parseIntCidString) ; 


4. Prompt the user for and accept the customer’s name. To ensure that entered 
names are stored using a uniform length, assign the name to a StringBuilder 
object, and set the length to the standard length. Then assign the newly sized 
StringBuilder back to the String. 


System.out.print("Enter name for customer >> "); 
name = input.nextLineQ; 

StringBuilder sb = new StringBuilder(name) ; 
sb.setLength(NAME_LENGTH) ; 

name = sb.toStringQ; 


5. Prompt the user for and accept the customer’s state of residence. (In a fully 
developed program, you would check the entered state against a list of valid 
states, but this step is omitted to keep the program shorter.) 


System.out.print("Enter state >> "); 
state = input.nextLineQ; 
(continues) 
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CHAPTER 13 File Input and Output 


(continued) 
6. Prompt the user for and accept the customer’s balance. Because you use 

the nextDouble() method to retrieve the balance, you follow it with a call to 

nextLine() to absorb the Enter key value left in the input stream. Then you 
722 can use the DecimalFormat class to ensure that the balance meets the format 
requirements of the file. Because the BALANCE_FORMAT String’s value is 
0000.00, zeros will be added to the front or back of any double that would 
not otherwise meet the standard. For example, 200.99 will be stored as 
0200.99 and 0.1 will be stored as 0001.00. Appendix C contains more 
information on the DecimalFormat class and describes other potential formats. 





System.out.printC"Enter balance >> "); 

balance = input.nextDoubleQ) ; 

input.nextLineQ ; 

DecimalFormat df = new DecimalFormat (BALANCE_FORMAT) ; 


7. Construct the String to be written to the file by concatenating the entered fields 
with the comma delimiter and the line separator. 


s = idString + delimiter + name + delimiter + 
state + delimiter + df.format(balance) + 
System. getProperty("line.separator") ; 


8. Convert the constructed String to an array of bytes, and wrap the array into a 
ByteBuffer. 


byte data[] = s.getBytesQ); 
ByteBuffer buffer = ByteBuffer.wrap(data) ; 


9. Depending on the customer's state, use the in-state or out-of-state FileChannel. 
Position the file pointer to start writing a record in the correct position based on 
the account number, and write the data String. 


if(state.equalsCHOME_STATE)) 

{ 
fcIn.positionCid * RECSIZE); 
fcIn.write(buffer) ; 

} 

else 

{ 
fcOut.position(id * RECSIZE); 
fcOut.write(buffer) ; 

} 


10. Prompt the user for the next customer account number, and add a closing curly 
brace for the while loop. 


System.out.printC"Enter next customer account number or " + 
QUIT + " to quit >> "); 
idString = input.nextLineQ ; 


: (continues) 
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(continued) 
11. Close the FileChannels, and add a closing curly brace for the class. 
fcIn.closeQ; 
fcOut.closeQ; 
} 723 





12. Save the file and compile it. Execute the program, and enter several 
records. Make sure to include names that are longer and shorter than 
10 characters and to include a variety of balance values. Figure 13-41 
shows a typical execution. 





= 
Command Prompt 








C:\Java>java CreateFilesBasedOnState 
* customer account number >> 213 
* name for customer >> Morris 
* state >> KY 
* balance >> 260.0606 
*“ next customer account number or 999 
* name for customer >> Johnsonville 
* state >> AZ 
* balance >> 44.44 
*“ next customer account number » 999 
* name for customer >> Samuels 
* state >> WI 
* balance >> 160.99 
*“ next customer account number 
* name for customer >> Davis 
* state >> FL 
* balance >> 2 
"“ next customer account number or 
* name for customer >> Franklin 
* state >> WI 
* balance >> 1634.38 
“ next customer account number or 





Figure 13-41 Typical execution of the CreateFi lesBasedOnState program 


13. Locate and open the InStateCusts.txt and OutOfStateCusts.txt files. 
Scroll through the files until you find the records you created. Figure 13-42 
shows part of both files that contains the records added using the execution 
in Figure 13-41. Confirm that each record is placed in the correct file 
location, that each name and balance is in the correct format, and that the 
records with a state value of “WI” are placed in one file while all the other 
records are placed in the other file. 


(continues) 
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(continued) 
a —_ 
“| InStateCusts - Notepad (= coy _| OutOfStateCusts - Note... 28 Lo 
File Edit Format View Help File Edit Format View Help 
724 ,WI, 0000. 000, ,WI ,0000. 00 





,WI,0000. 000, ,WI,0000. 00 
,WI, 0000. r 000, ,WI,0000. 00 
101,Franklin§ ,wI,1034. ooo, ,»WI,0000. 00 


ooo, ,»WI,0000. 212 ,Davis »FL,0002.00 
ooo, ,WI,0000. 213,Morris »KY,0200.00 
104 , Samuels ,WI,0100. 000, ,;WI,0000. 00 
ooo, ;WI,0000. 215, Johnsonvil,AzZ,0044.44 
ooo, ,WI,0000. ooo, ,WI,0000. 00 
opo, ,WI,0000. 000, ,WI,0000. 00 


4 4 











Figure 13-42 Contents of the files created by the program execution in Figure 13-41 


Setting Up a Program to Read the Created Files 


Now, you can write a program that can use either of the files you just created. The 
program has four parts: 


e The program will prompt the user to enter the filename to be used and set up all 
necessary variables and constants. 


e A few statistics about the file will be displayed. 
e The nondefault contents of the file will be displayed sequentially. 
e A selected record from the file will be accessed directly. 


1. Open a new file in your text editor. Enter all the required import statements and 
the class header for the ReadStateFile application. 


import java.nio.file.*; 

import java.io.*; 

import java.nio.file.attribute.*; 

import static java.nio.file.StandardOpenOption. *; 
import java.nio.ByteBuffer; 

import java.nio.channels.FileChannel ; 

import java.util .Scanner; 

public class ReadStateFile 

{ 


2. Declare a Scanner object to handle keyboard input. Then declare a String 
that will hold the name of the file the program will use. Prompt the user for 
the filename, concatenate it with the correct path, and create a Path 
object. 


(continues) 
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(continued) 
Scanner kb = new Scanner(System. in); 
String fileName; 
System.out.printC"Enter name of file to use >> "); 
fileName = kb.nextLineQ; 
fileName = "C:\\Java\\Chapter.13\\" + fileName; 725 
Path file = Paths.get(fileName) ; 


3. Add the String formatting constants and build a sample record String so 
that you can determine the record size. To save time, you can copy these 
declarations from the CreateFilesBasedOnState program. 








final String ID_FORMAT = "000"; 

final String NAME_FORMAT = " age 
final int NAME_LENGTH = NAME_FORMAT.lengthQ); 
final String HOME_STATE = "WI"; 

final String BALANCE_FORMAT = "0000.00"; 


String delimiter = ","; 

String s = ID_FORMAT + delimiter + NAME FORMAT + delimiter + 
HOME_STATE + delimiter + BALANCE FORMAT + 
System.getProperty("'line.separator") ; 

final int RECSIZE = s.lengthQ); 


4. The last set of declarations includes a byte array that you will use with a 
ByteBuffer later in the program, a String that represents the account 
number in an empty account, and an array of strings that can hold the pieces of a 
split record after it is read from the input file. Add a variable for the numeric 
customer balance, which will be converted from the string stored in the file. 
Also, declare a total and initialize it to O so the total customer balance due value 
can be accumulated. 


byte data[] = s.getBytesQ); 
final String EMPTY_ACCT = "000"; 
String[] array = new String[4]; 
double balance; 

double total = 0; 


5. Add two closing curly braces for the method and the class. Save the file as 
ReadStateFile.java. Compile the file and correct any errors. 


Displaying File Statistics 
In the next section of the program, you display the creation time and size of the file. 


1. Just before the two closing curly braces you just added to the program, insert a 
try block in which you declare a BasicFileAttributes object. Then add 
statements to display the file’s creation time and size. Include a catch block to 


handle any thrown exceptions. 
(continues) 
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(continued) 


try 


BasicFileAttributes attr = 

Files.readAttributes(file, BasicFileAttributes.class); 
726 System.out.printInC"\nAttributes of the file:"); 
System.out.printInC"Creation time " + attr.creationTimeQ); 
System.out.printin(C"Size " + attr.sizeQ); 





} 
catchC(IOException e) 


{ 


} 


2. Save the file, then compile and execute it. When prompted, you can type the 
name of either the InStateCusts.txt file or the OutOfStateCusts.txt file. 
Figure 13-43 shows a typical execution. 


- - 
fay Command Prompt ix 


C:\Java>java ReadStateFile 
Enter name of file to use >> OutOfStateCusts.txt 


System.out.printInC"IO Exception") ; 








Attributes of the file: 
Creation time 2616-608-36T66:35:17.20445Z2 
Size 2'7666 


C:z\Java> 





Figure 13-43 Typical execution of the ReadStateFi le program 
Reading a File Sequentially 


In these steps, you display all the entered records in the file of the user's choice. 


1. Start a new try..catch pair after the first one ends but before the two closing 
curly braces in the program. Declare an InputStream and BufferedReader to 
handle reading the file. 


try 
{ 
InputStream iStream = new 
Buf feredInputStream(Files.newInputStream(file)); 
BufferedReader reader = new 
BufferedReader (new InputStreamReader (iStream)) ; 


(continues) 
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(continued) 
2. Display a heading, and then read the first record from the file into a String. 
System.out.printInC"\nAl11 non-default records:\n"); 


s = reader.readLineQ; 
727 








3. In a loop that continues while there is more data to read, split the String using 
the comma delimiter. Test the first split element, the account number, and 
proceed only if itis not “OOO”. If the record was entered in the previous program, 
display the split String elements. Add the balance to a running total. As the last 
action in the loop, read the next record. 


while(s != null) 


{ 
array = s.split(delimiter) ; 
if(C!array[0] .equalsCEMPTY_ACCT)) 
{ 
balance = Double. parseDoub1e(array[3]) ; 
System.out.printinC"ID #" + array[0] +" "+ 
array[1] + array[2] +" $"+array[3]); 
total += balance; 
} 
s = reader.readLineQ; 
} 


4. After all the records have been processed, display the total and close the reader. 
Add a closing curly brace for the try block. 


System.out.printIn("Total of all balances is $" + total); 
reader.close() ; 


} 
5. Create a catch block to handle any thrown exceptions. 


catch(Exception e) 
{ 
System.out.printIn("Message: " +e); 


} 


6. Save the file, and then compile and execute it. Enter the name of either data file. 
Figure 13-44 shows a typical execution. After the file statistics are displayed, the 
records added earlier are also displayed, and the balances are accumulated. 


(continues) 
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(continued) 





C:\Java>java ReadStateFile 
728 Enter name of file to use >> OutOfStateCusts.txt 





Attributes of the file: 
Creation time 2616-68-36T66:35:17.26445Z 
Size 27600 


All non-default records: 


ID #212 Davis FL $0062.00 
ID #213 Morris KY $0206.00 
ID #215 JohnsonvilAZ $8044.44 
Total of all balances is 246.44 


C:z\Java> 








Figure 13-44 Typical execution of the ReadStateFi le program after code has 
been added to display records 


Reading a File Randomly 


In the last part of the program, you ask the user to enter an account number and then 
display the record directly by repositioning the file pointer. 


1. After the closing brace of the last catch block, but before the two final closing 
braces in the class, add a new try block that declares a FileChannel and 
ByteBuffer and then prompts the user for and accepts an account to search for 
in the file. 


try 
{ 
FileChannel fc = (FileChannel)Files.newByteChannel (file, READ); 
ByteBuffer buffer = ByteBuffer.wrap(data) ; 
int findAcct; 
System.out.print("\nEnter account to seek >> "); 
findAcct = kb.nextIntQ; 


2. Calculate the position of the sought-after record in the file by multiplying the 
record number by the file size. Read the selected record into the ByteBuffer, and 
convert the associated byte array to a String that you can display. Add a closing 
curly brace for the try block. 


fc.position(findAcct * RECSIZE); 
fc.read(buffer) ; 

s = new String(data) ; 
System.out.printIn("Desired record: " + s); 


} (continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall 





earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 








(continued) 
3. Adda catch block to handle any exceptions. 
catch(Exception e) 
{ 
System.out.printIn("Message: "+ e); 729 
} 


4. Save the file, and then compile and execute it. Figure 13-45 shows a typical 
execution. First, the file attributes are displayed, then all the records are 
displayed, and then a record selected by the user is displayed. 





Command Prompt _ - 


C:\Java>java ReadStateFile 
Enter name of file to use >> OutOfStateCusts.txt 


Attributes of the file: 
Creation time 2616-68-30T@6:35-:17.20445Z 
Size 27600 


All non-default records: 


Davis FL $6002.00 
mid #213 Morr KY $6200.00 
NID #215 JohnsonvilAZ $0044.44 
NTotal of all balances is 246.44 


HEnter account to seek >> 213 
Desired record: 213,Morris ~ KY, 6266.66 














Figure 13-45 Typical execution of the ReadStateFi le program after code 
has been completed 


Don't Do It 


e Don't forget that a Path name might be relative and that you might need to make the Path 
absolute before accessing it. 


e Don't forget that the backslash character starts the escape sequence in Java, so you 
must use two backslashes in a string that describes a Path in the DOS operating 
system. 
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Key Terms 
Volatile storage is temporary storage that is lost when a computer loses power. 


730 Random access memory (RAM) is the temporary storage within a computer. 





Nonvolatile storage is permanent storage; it is not lost when a computer loses power. 


A computer file is a collection of data stored on a nonvolatile device in a computer 
system. 


Permanent storage devices, such as hard disks, Zip disks, USB drives, reels or cassettes of 
magnetic tape, and compact discs, are nonvolatile and hold files. 


Text files contain data that can be read in a text editor because the data has been encoded 
using a scheme such as ASCII or Unicode. 


Data files contain facts and figures, such as a payroll file that contains employee numbers, 
names, and salaries. 


Program files or application files store software instructions. 


Binary files contain data that has not been encoded as text; their contents are in binary 
format. 


The root directory of a storage device is the main directory. 
Folders or directories are used to organize stored files. 


A path is the complete list of the disk drive plus the hierarchy of directories in which a file 
resides. 


A path delimiter is the character used to separate path components. 


You can use Java’s Path class to create objects that contain information about files 
and directories, such as their locations, sizes, creation dates, and whether they 
even exist. 


You use the Files class to perform operations on files and directories, such as deleting them, 
determining their attributes, and creating input and output streams. 










Factory methods are methods that assist in object creation. 


An absolute path is a complete path; it does not need any other information to locate a file on 
a system. 


A relative path is one that depends on other path information. 
Java’s static import feature allows you to use static constants without their class name. 


A TOCTTOU bug is an error that occurs when changes take place from Time Of Check To 
Time Of Use. 
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Chapter Sumary iii 


A character can be any letter, number, or other special symbol (such as a punctuation mark) 
that constitutes data. 


A field is a group of characters that has some meaning. 


A record is a collection of fields that contain data about an entity. 
731 








In a sequential access file, each record is accessed one after another in the order in which it 
was stored. 


Comma-separated values (CSV) are fields that are separated by a comma. 
To open a file is to create an object and associate a stream of bytes with it. 
To close the file is to make it no longer available to an application. 

A stream is a data pipeline or channel. 


A buffer is a memory location where bytes are held after they are logically output but before 
they are sent to the output device. 


Flushing clears any bytes that have been sent to a buffer for output but that have not yet been 
output to a hardware device. 


Batch processing involves performing the same tasks with many records, one after the other. 
Real-time applications require that a record be accessed immediately while a client is waiting. 
In an interactive program, a user makes direct requests to a system. 

Random access files are files in which records can be retrieved directly in any order. 
Direct access files and instant access files are alternate names for random access files. 

A file channel object is an avenue for reading and writing a file. 


Seekable describes a file channel in which you can search for a specific file location and in 
which operations can start at any specified position. 


To be wrapped is to be encompassed in another type. 


A key field is the field in a record that makes the record unique from all others. 


Chapter Summary 


e Data items can be stored on two broad types of storage devices—temporary, volatile 
storage, or permanent, nonvolatile storage. A computer file is a collection of data stored 
on a nonvolatile device. Files can be text files or binary files, but all files share 
characteristics, such as a size, name, and time of creation. 







e Java’s Path class is used to gather file information, such as its location, size, and creation date. 
You can use the Files class to perform operations on files and directories, such as deleting 
them, determining their attributes, and creating input and output streams. 
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e Businesses organize data in a hierarchy of character, field, record, and file. When a 
program performs input and output operations, bytes flow into a program stream, which 
functions as a pipeline or channel. A buffer is a memory location where bytes are held 
after they are logically output but before they are sent to the output device. Using a buffer 
to accumulate input or output improves program performance. Flushing clears any bytes 

732 that have been sent to a buffer for output but that have not yet been output to a hardware 

device. 





e InputStream, OutputStream, and Reader are subclasses of the Object class that are used 
for input and output. Output devices can be assigned to OutputStream references, 
allowing applications to save data to them. You can create a file and write to it by using the 
Files class newOutputStream() method. To open a file for reading, you can use the 
newInputStream() method. 


e The BufferedWriter class contains write() methods that are used to create data files. 
Files can be read using the BufferedReader class. The String class sp1it(@ method 
accepts an argument that identifies a field delimiter and returns an array of Strings in 
which each array element holds one field. 


e Businesses store data in sequential order when they use the records for batch processing. 
Real-time applications require interactive processing with random access files. Java’s 
FileChannel class creates random access files. A file channel is seekable, meaning you can 
search for a specific file location and operations can start at any specified position. 


e One approach to writing a random file is to place records into the file based on a key field 
that makes a record unique from all others. The first step in creating the random access 
file is to create a file that holds default records. Then you can replace any default record 
with actual data by setting the file channel position. 


e Youcan process a random access file either sequentially or randomly. The benefit of using 
a random access file is the ability to retrieve a specific record from a file directly, without 
reading through other records to locate the desired one. 


Review Questions 


1. Which of the following statements is true? 







a. Volatile storage lasts only a few seconds. 

b. Volatile storage is lost when a computer loses power. 
c. Computer disks are volatile storage devices. 

d. All of the above are true. 


2. Acollection of data stored on a nonvolatile device in a computer system 
is 
a. a file c. volatile 
b. an application d. a type of binary file 
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3. A complete list of the disk drive plus the hierarchy of directories in which a file 
resides is its 


a. directory c. delimiter 
b. folder d. path 
733 








4, Which of the following statements creates a Path named p to a FileStream named f? 


a. Path p = new PathC("C:\\Java\\MyFile.txt"); 

b. Path p = f("C:\\Java\\MyFile. txt"); 

c. Path p = f.getPath("C:\\Java\\MyFile.txt"); 

d. Path p = getPath(new f("C:\\Java\\MyFile.txt")); 


5. A path that needs no other information to locate a file on a system is 


a. an absolute path c. a final path 
b. a relative path d. aconstant path 


6. The Path class getFileName() method returns 


the String representation of a Path 
an absolute Path 
the first item in a Path’s list of name elements 


a0 Ff SP 


the last item in a Path’s list of name elements 
7. Which of the following statements always returns the same value as 
Files.exists(file)? 


a. file.checkAccess() c. file.checkAccess(READ, WRITE) 
b. file.checkAccess(EXISTS) d. file.checkAccess(file.exists()) 


8. You cannot delete a Path 


under any circumstances 


if it represents a directory 











a 
b 
c. if it represents a directory that is not empty 
d. if it represents more than five levels 


9. The data hierarchy occurs in the following order from the smallest to largest piece 


of data: 
a. character, field, record, file c. character, record, field, file 
b. character, file, record, field d. record, character, field, file 


10. When records are accessed one after the other in the order in which they 


were stored, their file is being used as a ___________ access file. 
a. random c. chronological 
b. binary d. sequential 
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11. If you fail to close an output file, 


there are usually no serious consequences 
you might lose access to the written data 
Java will close it for you automatically 


a0 Ff PS 


734 Two of the above are correct. 





12. Which of the following is true of streams? 


a. Streams are channels through which bytes flow. 
b. Streams always flow in two directions. 
c. Only one stream can be open in a program at a time. 
d. All of the above are true. 
13. <A buffer 
a. holds bytes that are scheduled for input or output 
b. deteriorates program performance 
c. cannot be flushed in Java 
d. All of the above are true. 


14. InputStream is 


a. achild of OutputStream 
b. an abstract class 
c. used for screen output as opposed to file output 
d. All of the above are true. 
15. Java’s printQ and printIn@ methods are defined in the __________ class. 
a. BufferedOutputStream c. PrintStream 
b. System d. Print 


16. The newOutputStream() method 










is defined in the Files class 
creates a file if it does not already exist 
opens a file for writing 


ao op 


All of the above are true. 


17. Which of the following does the same thing as the Bufferedwriter class 
newLine() method? 
a. System.getProperty("line.separator ") 
b. Path.getProperty("line.separator ") 
c. System.out.printin®d 
d. System.out.print("\n") 
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18. Which of the following systems is most likely to use batch processing? 








a. an airline reservation system c. point-of-sale credit checking 
b. payroll d. an e-mail application 
19. Real-time applications 735 
a. use sequential access files c. use random access files 
b. use batch processing d. seldom are interactive 


20. A file channel 


a. can be read from c. is seekable 
b. can be written to d. All of the above are true. 
Exercises 


=) Programming Exercises 


1. Create a file using any word-processing program or text editor. Write an 
application that displays the file’s name, containing folder, size, and time of last 
modification. Save the file as FileStatistics.java. 


2. Create two files using any word-processing program or text editor. Write an 
application that determines whether the two files are located in the same folder. 
Save the file as SameFolder.java. 


3. Create a file that contains your favorite movie quote. Use a text editor such as 
Notepad, and save the file as quote.txt. Copy the file contents, and paste them into 
a word-processing program such as Word. Save the file as quote.docx. Write an 
application that displays the sizes of the two files as well as the ratio of their sizes to 
each other. Save the file as FileStatistics2.java. 


4, Write an application that determines which, if any, of the following files are 
stored in the folder where you have saved the exercises created in this chapter: 
autoexec.bat, SameFolder.java, FileStatistics.class, and Hello.doc. Save the file as 
FindSelectedFiles.java. 














5. a. Create a program that accepts a series of employee ID numbers, first names, and 
last names from the keyboard and saves the data to a file. Save the program as 
WriteEmployeeList.java. When you execute the program, be sure to enter 
multiple records that have the same first name because you will search for 
repeated first names in part d of this exercise. 


b. Write an application that reads the file created by the WriteEmployeeList 
application and displays the records. Save the file as 
DisplaySavedEmployeeList.java. 
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c. Write an application that allows you to enter any ID number and displays the first 
and last name for the record stored in the employee file with the given ID number. 
Display an appropriate message if the ID number cannot be found in the input file. 
Save the file as DisplaySelectedIDNumbers.java. 


d. Write an application that allows you to enter any first name and displays all the 
736 : : ; 
ID numbers and last names for any records stored in the employee file with the 
given first name. Display an appropriate message if the first name cannot be 
found in the input file. Save the file as DisplaySelectedFirstNames.java. 





6. Using a text editor, create a file that contains a list of at least 10 six-digit account 
numbers. Read in each account number and display whether it is valid. An account 
number is valid only if the last digit is equal to the sum of the first five digits divided 
by 10. For example, the number 223355 is valid because the sum of the first five digits 
is 15, the remainder when 15 is divided by 10 is 5, and the last digit is 5. Write only 
valid account numbers to an output file, each on its own line. Save the application as 
ValidateCheckDigits.java. 


7. a. Write an application that allows a user to enter a filename and an integer 
representing a file position. Assume that the file is in the same folder as your 
executing program. Access the requested position within the file, and display the 
next 20 characters there. Save the file as SeekPosition.java. 


b. Modify the SeekPosition application so that instead of displaying 20 characters, 
the user enters the number of characters to display, beginning with the requested 
position. Save the file as SeekPosition2.java. 


8. a. Create an application that allows you to enter salesperson data that consists 
of an ID number, first name, last name, and current month sales in whole dollars. 
Depending on whether the salesperson’s sales value exceeds $1,000, output 
each record either to a high-performers file or a low-performers file. Save the 
program as HighAndLowSales.java. 


b. Create an application that displays each record in the two files created 
in the HighAndLowSales application in Exercise 8a. Display a heading to 
introduce the list produced from each file. For each record, display the ID 
number, first name, last name, sales value, and the amount by which the sales 
value exceeds or falls short of the $1,000 cutoff. Save the program as 
HighAndLowSalesDisplay.java. 










9. a. The Rochester Bank maintains customer records in a random access file. Write 
an application that creates 10,000 blank records and then allows the user to 
enter customer account information, including an account number that is 
9999 or less, a last name, and a balance. Insert each new record into a data file at 
a location that is equal to the account number. Assume that the user will not 
enter invalid account numbers. Force each name to eight characters, padding 
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it with spaces or truncating it if necessary. Also assume that the user 
will not enter a bank balance greater than 99,000.00. Save the file as 
CreateBankFile.java. 


b. Create an application that uses the file created by the user in Exercise 9a 
and displays all existing accounts in account-number order. Save the file as 


ReadBankAccountsSequentially.java. oad 








c. Create an application that uses the file created by the user in Exercise 9a and 
allows the user to enter an account number to view the account balance. Allow the 
user to view additional account balances until entering an application-terminating 
value. Save the file as ReadBankAccountsRandomly.java. 


10. a. Write a program that allows you to create a file of customers for a company. The first 
part of the program should create an empty file suitable for writing a three-digit ID 
number, six-character last name, and five-digit zip code for each customer. The 
second half of the program accepts user input to populate the file. For this exercise, 
assume that the user will correctly enter ID numbers and zip codes, but force the 
customer name to seven characters if it is too long or too short. Issue an error message, 
and do not save the records if the user tries to save a record with an ID number that 
has already been used. Save the program as CreateCustomerFile.java. 


b. Write a program that creates a file of items carried by the company. Include a 
three-digit item number and up to a 20-character description for each item. Issue 
an error message if the user tries to store an item number that has already been 
used. Save the program as CreateltemFile.java. 


c. Write an application that takes customer orders. Allow a user to enter a customer 
number and item ordered. Display an error message if the customer number does 
not exist in the customer file or the item does not exist in the item file; otherwise, 
display all the customer information and item information. Save the program as 
CustomerItemOrder.java. 


* Debugging Exercises 


Each of the following files in the Chapter13 folder of your downloadable 
student files has syntax and/or logic errors. In each case, determine the problem 
and fix the program. After you correct the errors, save each file using the same 
filename preceded with Fix. For example, DebugThirteen1 java will become 
FixDebugThirteen1 java. 










a. DebugThirteenl.java c. DebugThirteen3.java 
b. DebugThirteen2.java d. DebugThirteen4.java 


The Chapter13 folder contains four additional data files named DebugDatal.txt, 
DebugData2.txt, DebugData3.txt, and DebugData4.txt. These files are used by the 
Debug programs. 
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5 Game Zone 


In several Game Zone assignments earlier in this book, you created games similar to 

Hangman in which the user guesses a secret phrase by selecting a series of letters. 
738 These versions had limited appeal because each contained only a few possible 
phrases to guess; after playing the games a few times, the user would have mem- 
orized all the phrases. Now create a version in which any number of secret phrases 
can be saved to a file before the game is played. Use a text editor such as Notepad to 
type any number of phrases into a file, one per line. Save the file as Phrases.txt. 
Then, create a game that randomly selects a phrase from the file and allows a user to 
guess the phrase letter by letter. Save the game as SecretPhraseUsingFile.java. 





2. In Chapter 8, you created a game named Quiz in which the user could respond to 
multiple-choice questions. Modify the game so that it stores the player’s highest 
score from any previous game in a file and displays the high score at the start of 
each new game. (The first time you play the game, the high score is 0.) Save the 
game as QuizUsingFile.java. 


3. Usea text editor to create a comma-delimited file of user IDs and passwords. Revise 
any one of the games you have created throughout this book so the user must first 
enter a correct ID and its associated password before playing. Save the program as 
Game WithPassword.java. 


Case Problems 





a. In Chapter 12, you created an interactive StaffDinnerEvent class that obtains 
all the data for a dinner event for Carly’s Catering, including details about the 
event and all the staff members required to work at the event. Now, modify the 
program to prompt the user for data for three dinner events and to create a data 
file that contains each event number, event type code, number of guests, and 
price. Save the program as StaffDinnerEventAndCreateFile.java. 


b. Write a program that displays the data saved in the file created in part la. Save 
the program as DisplayDinnerEventFile.java. 













2. a. In Chapter 12, you created an interactive RentalDemo class that obtains all the 
data for four rentals from Sammy’s Seashore Rentals, including details about the 
contract number, length of the rental, and equipment type. Now, modify the 
program to create a data file that contains each contract number, rental time in 
hours and minutes, equipment type code and name, and price. Save the program 
as RentalDemoAndCreateFile.java. 


b. Write a program that displays the data saved in the file created in part 2a. Save 
the program as DisplayRentalFile.java. 
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Introduction to Swing 
Components 


In this chapter, you will: 


Understand Swing components 


(©) 


Use the JFrame class 
Use the JLabel class 
Use a layout manager 


(ORT ORTO) 


Extend the JFrame class 
Add JTextFields, JButtons, and tool tips to a JFrame 
Learn about event-driven programming 


(ORT OREO) 


Understand Swing event listeners 


Use the JCheckBox, ButtonGroup, and JComboBox 
classes 


(ORO) 





Unless noted otherwise, all images are © 2014 Cengage Learning 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 14 Introduction to Swing Components 


Understanding Swing Components 


Computer programs usually are more user friendly (and more fun to use) when they contain 

user interface (UI) components. Ul components are buttons, text fields, and other 

components with which the user can interact. Java’s creators have packaged a number of 
740 prewritten components in the Swing package. Swing components are UI elements such as 
dialog boxes and buttons; you can usually recognize their names because they begin with /. 





imply that the components have style and pizzazz. You have already used the JOptionPane component 
that is part of the Swing class. The Swing classes are part of a more general set of Ul programming 
capabilities that are collectively called the Java Foundation Classes, or JFC. JFC includes Swing 
component classes and selected classes from the java. awt package. 


Q Swing components were named after a musical style that was popular in the 1940s. The name is meant to 


created from these original classes did not have a consistent appearance when used with different browsers 
and operating systems. When Java's creators designed new, improved classes, they needed new names for 
the classes, so they used a J in front of each new class name. Hence, Swing components have names like 
JFrame, JButton, JScrollbar, JOptionPane, and so on. 


Q In early versions of Java, components had simple names, such as Frame and Button. The components 


UI components are also called controls or widgets. Each Swing component is a descendant of a 
JComponent, which in turn inherits from the java. awt.Container class. You can insert the 
statement import javax.swing.*; at the beginning of your Java program files so you can 
take advantage of the Swing UI components and their methods. When you import Swing 
classes, you use the javax.swing package instead of java.swing. The x originally stood for 
extension, so named because the Swing classes were an extension of the original Java language 
specifications. 


completely in Java and do not have to rely on the local operating system code. This means the 
components are not “weighed down” by having to interact with the operating system (for example, 
Windows or Macintosh) in which the application is running. Some Swing components, such as 
JFrames, are known as heavyweight components because they do require interaction with the local 
operating system. A lightweight component reuses the native (original) window of its closest 
heavyweight ancestor; a heavyweight component has its own opaque native window. The only 
heavyweight components used in Swing are swing.JFrame, swing.JDialog, swing. JWindow, 
swing. JApplet, awt.Component, awt.Container, and awt.JComponent. 


Q Almost all Swing components are said to be lightweight components because they are written 


When you use Swing components, you usually place them in containers. A container is a type 
of component that holds other components so you can treat a group of them as a single 
entity. Containers are defined in the Container class. Often, a container takes the form of 
a window that you can drag, resize, minimize, restore, and close. 


As you know from reading about inheritance in Chapters 10 and 11, all Java classes descend 
from the Object class. The Component class is a child of the Object class, and the Container 
class is a child of the Component class. Therefore, every Container object “is a” Component, 
and every Component object (including every Container) “is an” Object. The Container class 
is also a parent class, and the Window class is a child of Container. However, Java 
programmers rarely use Window objects because the Window subclass Frame and its child, 
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the Swing component JFrame, both allow you to create more useful objects. Window objects 
do not have title bars or borders, but JFrame objects do. 


741 








Understanding Swing Components 


1. Swing components are elements such as buttons; you can usually recognize 
their names because they contain the word Swing. 


2. Each Swing component is a descendant of a JComponent, which in turn inherits 
from the java.awt.Container Class. 


3. You insert the import statement import javax.swing.*; at the beginning of 
your Java program files so you can use Swing components. 
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Using the JFrame Class 


You usually create a JFrame so that you can place other objects within it for display. 

Figure 14-1 shows the JFrame’s inheritance tree. Recall that the Object class is defined in the 
java.lang package, which is imported automatically every time you write a Java program. 
However, Object’s descendants (shown in Figure 14-1) are not automatically imported. 





java.lang.Object 
+-- java.awt.Component 
e--java.awt .Container 
|__java.awt. window 
\_. java.awt.Frame 
ee -javax.swing.JFrame 





Figure 14-1 Relationship of the JFrame class to its ancestors 


The JFrame class has four constructors: 
e JFrameQ constructs a new frame that initially is invisible and has no title. 
e JFrame(String title) creates a new, initially invisible JFrame with the specified title. 


e JFrame(GraphicsConfiguration gc) creates a JFrame in the specified 
GraphicsConfiguration of a screen device with a blank title. (You will learn about the 
GraphicsConfi guration class as you continue to study Java.) 
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e JFrame(String title, GraphicsConfiguration gc) creates a JFrame with the specified 
title and the specified GraphicsConfiguration of a screen. 


You can construct a JFrame as you do other objects, using the class name, an identifier, the 
assignment operator, the new operator, and a constructor call. For example, the following two 


742 statements construct two JFrames: one with the title “Hello” and another with no title: 





JFrame firstFrame = new JFrame("Hello"); 
JFrame secondFrame = new JFrame(); 


After you create a JFrame object, you can use the now-familiar object-dot-method format you 
have used with other objects to call methods that manipulate a JFrame’s features. Table 14-1 
describes some useful JFrame class methods. 


JFrame. Each of the methods listed in Table 14-1 is inherited from either JFrame’s Component or Frame 
parent class. These classes contain many useful methods in addition to the few listed here. You can read the 
documentation for all the methods at www.oracle.com/technetwork/java/index.html. 


Q The methods in Table 14-1 represent only a small portion of the available methods you can use with a 


Method 


Purpose 





void setTitle(String) 


void setSizeCint, int) 


void setSize(Dimension) 


String getTitleQ 


void setResizable(boolean) 


boolean isResizable() 


void setVisible(boolean) 


void setBounds(Cint, int, 
int, int) 


Sets a JFrame’s title using the String argument 


Sets a JFrame’s size in pixels with the width and height as 
arguments 


Sets a JFrame’s size using a Dimension class object; the 
Dimension(int, int) constructor creates an object that 
represents both a width and a height 


Returns a JFrame’s title 


Sets the JFrame to be resizable by passing true to the 
method, or sets the JFrame not to be resizable by passing 
false to the method 


Returns true or false to indicate whether the JFrame is 
resizable 


Sets a JFrame to be visible using the boolean argument true 
and invisible using the boolean argument false 


Overrides the default behavior for the JFrame to be positioned 
in the upper-left corner of the computer screen’s desktop. The 
first two arguments are the horizontal and vertical positions of 
the JFrame’s upper-left corner on the desktop. The final two 
arguments set the width and height. 


WE) )(28 Useful methods inherited by the JFrame class 
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Assuming you have declared a JFrame named firstFrame, you can use the following 
statements to set the firstFrame object’s size to 250 pixels horizontally by 100 pixels 
vertically and set the JFrame’s title to display a String argument. Pixels are the picture 
elements, or tiny dots of light, that make up the image on your computer monitor. 


firstFrame.setSize(250, 100); 743 
firstFrame.setTitle("My frame"); 








When you set a JFrame’s size, you do not have the full area available to use because part of the 
area is consumed by the JFrame’s title bar and borders. 


Figure 14-2 shows an application that creates a small, empty JFrame. 


import javax.swing.*; 
public class JFramel 


{ 


public static void main(String[] args) 

{ 
JFrame aFrame = new JFrame("First frame"); 
aFrame.setSize(250, 100); 
aFrame.setVisible(true) ; 


} 





Figure 14-2. The JFrame application 


The application in Figure 14-2 produces the JFrame shown in Figure 14-3. It resembles 
frames that you have probably seen when using different UI programs you have downloaded 
or purchased. One reason to use similar frame objects in your own programs is that users are 
already familiar with the frame environment. When users see frames on their computer 
screens, they expect to see a title bar at the top containing text information (such as “First 
frame”). Users also expect to see Minimize, Maximize or Restore, and Close buttons in the 
frame’s upper-right corner. Most users assume that they can change a frame’s size by 
dragging its border or reposition the frame on their screen by dragging the frame’s title bar to 
a new location. The JFrame in Figure 14-3 has all of these capabilities. 





|5| First frame = 











Figure 14-3 Output of the JFrame1 application 


In the application in Figure 14-2, all three statements in the main() method are important. 
After you instantiate aFrame, if you do not use setVisible(true), you do not see the JFrame, 
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and if you do not set its size, you see only the title bar of the JFrame because the JFrame size is 
0 x 0 by default. It might seem unusual that the default state for a JFrame is invisible. 
However, consider that you might want to construct a JFrame in the background while other 
actions are occurring and that you might want to make it visible later, when appropriate (for 
example, after the user has taken an action such as selecting an option). To make a frame 
744 visible, some Java programmers use the show() method instead of the setVisible() method. 





When a user closes a JFrame by clicking the Close button in the upper-right corner, the 
default behavior is for the JFrame to become hidden and for the application to keep 
running. This makes sense when there are other tasks for the program to complete after 
the main frame is closed—for example, displaying additional frames, closing open data 
files, or printing an activity report. However, when a JFrame serves as a Swing 
application’s main user interface (as happens frequently in interactive programs), you 
usually want the program to exit when the user clicks the Close button. To change this 
behavior, you can call a JFrame’s setDefaultCloseOperation() method and use one of 
the following four values as an argument: 


e JFrame.EXIT_ON_CLOSE exits the program when the JFrame is closed. 


e WindowConstants.DISPOSE_ON_CLOSE closes the frame, disposes of the JFrame object, and 
keeps running the application. 


e WindowConstants.DO_NOTHING_ON_CLOSE keeps the JFrame open and continues running. 
In other words, it disables the Close button. 


e WindowConstants.HIDE_ON_CLOSE closes the JFrame and continues running; this is the 
default operation that you frequently want to override. 


When you execute an application in which you have forgotten to exit when the JFrame is 
closed, you can end the program by typing Ctrl+C. 


the value of JFrame. EXIT_ON_CLOSE is 3. However, it is easier to remember the constant names than 
the numeric values they represent, and other programmers more easily understand your intentions if you use 
the named constant identifier. 


QG Each of the four usable setDefaultCloseOperation() arguments represents an integer; for example, 


Customizing a JFrame’s Appearance 


The appearance of the JFrame in Figure 14-3 is provided by the operating system in which the 
program is running (in this case, Windows). For example, the coffee-cup icon in the frame’s 
title bar and the Minimize, Restore, and Close buttons look and act as they do in other 
Windows applications. The icon and buttons are known as window decorations; by default, 
window decorations are supplied by the operating system. However, you can request that 
Java’s look and feel provide the decorations for a frame. A look and feel is the default 
appearance and behavior of any user interface. 


Optionally, you can set a JFrame’s look and feel using the setDefau1 tLookAndFeelDecorated() 
method. For example, Figure 14-4 shows an application that calls this method. 
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import javax.swing.*; 
public class JFrame2 
{ 
public static void main(String[] args) 
{ 745 
JFrame.setDefaultLookAndFeelDecorated(true) ; 
JFrame aFrame = new JFrame("Second frame"); 
aFrame.setSize(250, 100); 
aFrame.setVisible(true) ; 








Figure 14-4 The JFrame2 class 


You can provide a custom icon for a frame instead of using your operating system’s default icon or the Java 
Y look-and-feel icon. For details, go to the Java Web site and search for “How to Make Frames.” 


The program in Figure 14-4 differs from Figure 14-2 only in the shaded areas, which show the 
class name, the text in the title bar, and the look-and-feel statement. Figure 14-5 shows 

the output. If you compare the frame in Figure 14-5 with the one in Figure 14-3, you can see 
that Java’s look and feel has similar features to that of Windows, but their appearance is 
different. Java’s look and feel is also known by the name Metal. 


F] Second frame 





Figure 14-5 Output of the JFrame2 application 
their copyright protection by copying the look and feel of their products. 


Q Look and feel is a legal issue because some software companies claim that competitors are infringing on 


ee : : 
= Watch the video Using the JFrame class. 
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Using the JFrame Class 


746 1. The JFrame class contains overloaded constructors; for example, you can 
specify a title or not. 





2. An advantage of using a JFrame is that it resembles traditional frames that 
people are accustomed to using. 


3. When a user closes a JFrame by clicking the Close button in the upper-right 
corner, the default behavior is for the application to end. 
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«a You Do It 


Creating a JFrame 
In this section, you create a JFrame object that appears on the screen. 


1. Open anew file in your text editor, and type the following statement to import 
the javax.swing Classes: 


import javax.swing.*; 


2. On the next lines, type the following class header for the JDemoFrame Class, its 
opening curly brace, the main@ method header, and its opening curly brace: 


public class JDemoFrame 


{ 


public static void main(String[] args) 


{ 


3. Within the body of the main© method, enter the following code to declare a 
JFrame with a title, set its size, and make it visible. If you neglect to set a 
JFrame’s size, you see only the title bar of the JFrame (because the size is 
0 x O by default); if you neglect to make the JFrame visible, you do not see 
anything. Add two closing curly braces—one for the main() method and one 
for the JDemoFrame class. 


(continues) 
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(continued) 


JFrame aFrame = new JFrame("This is a frame"); 
final int WIDTH = 250; 

final int HEIGHT = 250; 747 
aFrame.setSizeC(WIDTH, HEIGHT); 
aFrame.setVisible(true); 








} 


4. Save the file as JDemoFrame.java. Compile and then run the program. The 
output looks like Figure 14-6—an empty JFrame with a title bar, a little taller than 
it is wide. The JFrame has all the properties of frames you have seen in 
applications you have used. For example, click the JFrame’s Minimize button, 
and the JFrame minimizes to an icon on the Windows taskbar. 








|| This is a frame 

















Figure 14-6 Output of the JDemoFrame application 


Click the JFrame’s icon on the taskbar. The JFrame returns to its previous size. 
Click the JFrame’s Maximize button. The JFrame fills the screen. 
Click the JFrame’s Restore button. The JFrame returns to its original size. 


ee oe) 


Position your mouse pointer on the JFrame’s title bar, and then drag the JFrame 
to a new position on your screen. 


9. Click the JFrame’s Close button. The JFrame disappears or hides. The default 
behavior of a JFrame is simply to hide when the user clicks the Close button—not 
to end the program. 


(continues) 
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(continued) 


10. Toend the program and return control to the command line, click the Command 
Prompt window, and then press Ctrl+C. In Chapter 6, you learned to press 

748 Ctrl+C to stop a program that contains an infinite loop. This situation is similar— 
you want to stop a program that does not have a way to end automatically. 





Ending an Application When a JFrame Closes 


Next, you modify the JDemoFrame program so that the application ends when the user 
clicks the JDemoFrame Close button. 


1. Within the JDemoFrame class file, change the class name to 
JDemoFrameThatCloses. 


2. Add anew line of code as the final executable statement within the mainQ 
method, as follows: 


aFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


3. Save the file as JDemoFrameThatCloses.java, and compile and execute the 
application. 


4. When the JFrame appears on your screen, confirm that it still has Minimize, 
Maximize, and Restore capabilities. Then click the JFrame’s Close button. The 
JFrame closes, and the command prompt returns as the program relinquishes 
control to the operating system. 


Using the JLabel Class 


One of the components you might want to place on a JFrame is a JLabel. JLabel is a built-in 
Java Swing class that holds text you can display. The inheritance hierarchy of the JLabel class 
is shown in Figure 14-7. 





java.lang.Object 


+--java.awt,Component 


+--java.awt.Container 


+--javax.swing.JComponent 


+--javax.swing.JLabel 











Figure 14-7 The JLabel class inheritance hierarchy 
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Available constructors for the JLabel class include the following: 
e JLabelQ creates a JLabel instance with no image and with an empty string for the title. 
e JLabel(Icon image) creates a JLabel instance with the specified image. 


e JLabel(Icon image, int horizontalAlignment) creates a JLabel instance with the 


749 
specified image and horizontal alignment. 








e JLabel(String text) creates a JLabel instance with the specified text. 


e JLabel(String text, Icon icon, int horizontalAlignment) creates a JLabel 
instance with the specified text, image, and horizontal alignment. 


e JLabel(String text, int horizontalAlignment) creates a JLabel instance with the 
specified text and horizontal alignment. 


For example, you can create a JLabel named greeting that holds the words “Good day” by 
writing the following statement: 


JLabel greeting = new JLabel("Good day"); 


You then can add the greeting object to the JFrame object named aFrame using the 
add() method as follows: 


aFrame.add(greeting) ; 


Figure 14-8 shows an application in which a JFrame is created and its size, visibility, and 
close operation are set. Then a JLabel is created and added to the JFrame. Figure 14-9 shows 
the output. 


import javax.swing.*; 
public class JFrame3 
{ 
public static void main(String[] args) 


{ 


final int FRAME_WIDTH = 250; 
final int FRAME_HEIGHT = 100; 


JFrame aFrame = new JFrameC("Third frame"); 
aFrame.setSizeC(FRAME_WIDTH, FRAME_HEIGHT) ; 
aFrame.setVisible(true) ; 
aFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
JLabel greeting = new JLabel("Good day"); 
aFrame.add(greeting) ; 





Figure 14-8 The JFrame3 class 
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Figure 14-9 Output of the JFrame3 application 


The counterpart to the addQ method is the remove() method. The following statement 
removes greeting from aFrame: 


aFrame.remove(greeting) ; 


If you add or remove a component from a container after it has been made visible, you should 
also call the invalidate(), validate(), and repaint() methods, or else you will not see the 
results of your actions. Each performs slightly different functions, but all three together 
guarantee that the results of changes in your layout will take effect. The invalidateQ) and 
validate() methods are part of the Container class, and the repaint() method is part of 
the Component class. 


you later alter the component—for example, by changing its text. You only need to call repaint () if you 
add or remove a component after construction. You will learn more about the repaint() method in the 
Graphics chapter. 


Q If you add or remove a component in a JFrame during construction, you do not have to call repaint () if 


You can change the text in a JLabel by using the Component class setText() method with the 
JLabel object and passing a String to it. For example, the following code changes the value 
displayed in the greeting JLabe: 


greeting.setText ("Howdy") ; 


You can retrieve the text in a JLabel (or other Component) by using the getText() method, 
which returns the currently stored String. 


Changing a JLabel’s Font 


If you use the Internet and a Web browser to visit Web sites, you probably are not very 
impressed with the simple application displayed in Figure 14-9. You might think that 

the string “Good day” is plain and lackluster. Fortunately, Java provides you with a 

Font class from which you can create an object that holds typeface and size information. 
The setFont() method requires a Font object argument. To construct a Font object, you 
need three arguments: typeface, style, and point size. 


e The typeface argument to the Font constructor is a String representing a font. Common 
fonts have names such as Arial, Century, Monospaced, and Times New Roman. 
The typeface argument in the Font constructor is only a request; the system on which 
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your program runs might not have access to the requested font, and if necessary, it 
substitutes a default font. 


e The style argument applies an attribute to displayed text and is one of three values: Font. 
PLAIN, Font.BOLD, or Font. ITALIC. 


e The point size argument is an integer that represents about 1/72 of an inch. Printed text is 751 
commonly 12 points; a headline might be 30 points. 








The point size is based on typographic points, which are approximately 1/72 of an inch. Java adopts the 
convention that one point on a display is equivalent to one unit in user coordinates. For more information, 
see the Font documentation at the Java Web site. 


Q In printing, point size defines a measurement between lines of text in a single-spaced text document. 


To give a JLabel object a new font, you can create a Font object, as in the following: 

Font headlineFont = new Font("Monospaced", Font.BOLD, 36); 

The typeface name is a String, so you must enclose it in double quotation marks. 

You can use the setFont() method to assign the Font to a JLabel with a statement such as: 
greeting.setFont (headlineFont) ; 


Figure 14-10 shows a class named JFrame4. All the changes from JFrame3 are shaded. 


import javax.swing.*; 
import java.awt.*; 
public class JFrame4 
{ 
public static void main(String[] args) 


{ 


final int FRAME_WIDTH = 250; 
final int FRAME HEIGHT = 100; 
Font headlineFont = new Font("Arial", Font.BOLD, 36); 


JFrame aFrame = new JFrame("Fourth frame"); 
aFrame.setSizeC(FRAME_WIDTH, FRAME_HEIGHT) ; 
aFrame.setVisible(true) ; 
aFrame.setDefaul1tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
JLabel greeting = new JLabel("Good day"); 
greeting.setFont(headlineFont) ; 

aFrame.add(greeting) ; 





Figure 14-10 The JFrame4 program 


The program in Figure 14-10 includes a new import statement for the package that contains 
the Font class. The program contains a Font object named headlineFont that is applied to 
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the greeting. Figure 14-11 shows the execution of the JFrame4 program; the greeting appears 
in a 36-point, bold, Arial font. 








|| Fourth frame = Lo" 


Good day 
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Figure 14-11 Output of the JFrame4 program 


You are not required to provide an identifier for a Font. For example, you could omit the 
shaded statement that declares head1ineFont in Figure 14-10 and set the greeting Font with 
the following statement that uses an anonymous Font object: 


greeting.setFont(new FontC"Arial", Font.BOLD, 36)); 


After you create a Font object, you can create a new object with a different type and size using 
the deriveFont() method with appropriate arguments. For example, the following two 
statements create a headlineFont object and a textBodyFont object that is based on the 
first object: 


Font headlineFont new FontC("Arial", Font.BOLD, 36); 
Font textBodyFont = headlineFont.deriveFont(Font.PLAIN, 14); 


Using the JLabel Class 


1. JLabel is a builtin Java Swing class that holds text you can display. 


2. You can change a JLabe1’s text by using its JFrame’s name, a dot, and the 
add) method, and then using the desired text as the argument to the method. 


3. If you add or remove a component from a container after it has been made 
visible, you should also call the validateQ and repaint() methods, or else 
you will not see the results of your actions. 
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Using a Layout Manager 


When you want to add multiple components to a JFrame or other container, you usually need 

to provide instructions for the layout of the components. For example, Figure 14-12 shows an 
application in which two JLabels are created and added to a JFrame in the final shaded 

statements. 753 








import javax.swing.*; 

import java.awt.*; 

public class JFrame5 

{ 
public static void main(String[] args) 
{ 


final int FRAME_WIDTH = 250; 
final int FRAME_HEIGHT = 100; 
JFrame aFrame = new JFrame("Fifth frame"); 


aFrame.setSize(FRAME_WIDTH, FRAME_HEIGHT) ; 
aFrame.setVisible(true); 
aFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
JLabel greeting = new JLabel("Hello"); 

JLabel greeting2 = new JLabelC"Who are you?"); 
aFrame.add(greeting) ; 

aFrame.add(greeting2) ; 





Figure 14-12 The JFrame5 program 


Figure 14-13 shows the output of the application in Figure 14-12. Although two JLabels are 
added to the frame, only the last one added is visible. The second JLabel has been placed on 
top of the first one, totally obscuring it. If you continued to add more JLabels to the program, 
only the last one added to the JFrame would be visible. 





|| Fifth frame 


0 are you? 





Figure 14-13 Output of the JFrame5 program 


To place multiple components at specified positions in a container so they do not hide each 
other, you must explicitly use a layout manager—a class that controls component 
positioning. The normal (default) behavior of a JFrame is to use a layout format named 
BorderLayout. A BorderLayout, created by using the BorderLayout class, divides a container 
into regions. When you do not specify a region in which to place a component (as the 
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JFrame5 program fails to do), all the components are placed in the same region, and they 
obscure each other. 


When you use a FlowLayout instead of a BorderLayout, components do not lie on top of each 
other. Instead, the flow layout manager places components in a row, and when a row is filled, 


= components automatically spill into the next row. 





Three constants are defined in the FlowLayout class that specify how components are 
positioned in each row of their container. These constants are FlowLayout.LEFT, 
FlowLayout.RIGHT, and FlowLayout.CENTER. For example, to create a layout manager named 
flow that positions components to the right, you can use the following statement: 


FlowLayout flow = new FlowLayout(FlowLayout.RIGHT) ; 

If you do not specify how components are laid out, by default they are centered in each row. 
Suppose that you create a FlowLayout object named flow as follows: 

FlowLayout flow = new FlowLayout(); 


Then the layout of a JFrame named aFrame can be set to the newly created FlowLayout using 
the statement: 


aFrame.setLayout (flow) ; 
A more compact syntax that uses an anonymous FlowLayout object is: 
aFrame.setLayout(new FlowLayout()) ; 


Figure 14-14 shows an application in which the JFrame’s layout manager has been set so that 
multiple components are visible. 


import javax.swing.*; 
import java.awt.*; 
public class JFrame6 
{ 
public static void main(String[] args) 
{ 
final int FRAME_WIDTH = 250; 
final int FRAME_HEIGHT = 100; 
JFrame aFrame = new JFrame("Sixth frame"); 
aFrame.setSizeC(FRAME_WIDTH, FRAME_HEIGHT) ; 


aFrame.setVisible(true) ; 
aFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
JLabel greeting = new JLabel("Hello"); 

JLabel greeting2 = new JLabelC"Who are you?"); 
aFrame.setLayout(new FlowLayout()); 
aFrame.add(greeting) ; 

aFrame.add(greeting2) ; 





Figure 14-14 The JFrame6 program 
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Figure 14-15 shows the execution of the JFrame6 program. Because a FlowLayout is used, the 
two JLabels appear side by side. If there were more JLabels or other components, they 
would continue to be placed side by side across the JFrame until there was no more room. 
Then, the additional components would be placed in a new row beneath the first row of 


components. 
755 











|| Sixth frame 


Hello Who are you? 





Figure 14-15 Output of the JFrame6 program 


these in the Graphics chapter. The examples in this chapter will use FlowLayout because it is the easiest 


Other layout managers allow you to position components in a container more precisely. You will learn about 
Y of the layout managers to use. 


ee 
= Watch the video Using a Layout Manager. 


Using a Layout Manager 


1. If you do not provide a layout manager for a JFrame, you cannot add multiple 
components to it. 


2. The normal (default) behavior of a JFrame is to use a layout format named 
BorderLayout. 


3. The flow layout manager places components in a row, and when a row is filled, it 
automatically spills components into the next row. 
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Extending the JFrame Class 


You can instantiate a simple JFrame object within an application’s main@ method or with any 

other method of any class you write. Alternatively, you can create your own class that 

descends from the JFrame class. The advantage of creating a child class of JFrame is that you 
756 can set the JFrame’s properties within your object’s constructor; then, when you create your 
JFrame child object, it is automatically endowed with the features you have specified, such as 
title, size, and default close operation. 





You already know that you create a child class by using the keyword extends in the class 
header, followed by the parent class name. You also know that you can call the parent class’s 
constructor using the keyword super, and that when you call super(), the call must be the 
first statement in the constructor. For example, the JMyFrame class in Figure 14-16 extends 
JFrame. Within the JMyFrame constructor, the super() JFrame constructor is called; it 
accepts a String argument to use as the JFrame’s title. (Alternatively, the setTitle() method 
could have been used.) The JMyFrame constructor also sets the size, visibility, and default 
close operation for every JMyFrame. Each of the methods—setSize(), setVisible(Q), and 
setDefaultCloseOperation() —appears in the constructor in Figure 14-16 without an 
object, because the object is the current JMyFrame being constructed. Each of the three 
methods could be preceded with a this reference with exactly the same meaning. That is, 
within the JMyFrame constructor, the following two statements have identical meanings: 


setSize(WIDTH, HEIGHT); 
this.setSize(WIDTH, HEIGHT); 


Each statement sets the size of “this” current JMyFrame instance. 


import javax.swing.*; 
public class JMyFrame extends JFrame 
{ 

final int WIDTH = 200; 

final int HEIGHT = 120; 

public JMyFrame() 

{ 


super("My frame"); 

setSize(WIDTH, HEIGHT); 

setVisible(true) ; 
setDefaul1tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 





Figure 14-16 The JMyFrame class 


Figure 14-17 shows an application that declares two JMyFrame objects. Each has the same set 
of attributes, determined by the JMyFrame constructor. 
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public class CreateTwoJMyFrameObjects 


{ 


public static void main(String[] args) 
{ 
JMyFrame myFrame = new JMyFrame(); 757 
JMyFrame mySecondFrame = new JMyFrame(); 








Figure 14-17 The CreateTwoJMyFrameObjects application 


When you execute the application in Figure 14-17, the two JMyFrame objects are displayed 
with the second one on top of, or obscuring, the first. Figure 14-18 shows the output of the 
CreateTwoJMyFrameObjects application after the top JMyFrame has been dragged to partially 
expose the bottom one. 





rc 





|4| My frame 





Figure 14-18 Output of the CreateTwoJMyFrameObjects application after dragging 
the top frame 


Figure 14-18 so that you don’t have to move one JMyFrame object to view the other. See Table 14-1 for 
details. The Object class also includes a setLocation() method you can use with a JFrame. To use 
this method, you provide horizontal and vertical position values as method arguments. You will learn more 
about the setLocation() method in the chapter Applets, Images, and Sound. 


Q You could use the setBounds() method with one of the JMyFrame objects that produces the output in 


Figure 14-18. Each object has the same default close operation because each uses the same constructor 
that specifies this operation. To allow only one JMyFrame to control the program's exit, you could use the 
setDefaultCloseOperation() method with one or both of the objects in the application to change its 
close behavior. For example, you could use DISPOSE_ON_CLOSE to dismiss one of the frames but keep the 
application running. 


Q You exit the application when you click the Close button on either of the two JMyFrame objects shown in 


When you extend a JFrame to create a new custom class, you must remember to make 
decisions as to which attributes you want to set within the class and which you want to leave 
to the applications that will use the class. For example, you can place the setVisibleQ 
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statement within the JFrame child class constructor (using either an explicit or implied this 
reference), or you can allow the application to use a setVisible() statement (using the name 
of an instantiated object followed by a dot and the method name). Either one works, but if you 
fail to do either, the frame will not be visible. 


provides the option to be used to instantiate objects, as in the CreateTwoJMyFrameObjects application, 


Programmers frequently place amain() method within a class such as JMyFrame. Then the class 
GY or to be used to execute as a program that creates an object. 





Extending the JFrame Class 


1. The advantage of creating a child class of JFrame is that you can set the 
JFrame’s properties within your object’s constructor so it is automatically 
endowed with the features that you have specified. 


2. When aclass descends from JFrame, you can use super() Or setTitle() to 
set the title within any of the child’s methods. 


3. When you extend a JFrame to create a new custom class, you can decide which 
attributes you want to set within the class and which you want to leave to the 
applications that will use the class. 
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Adding JTextFields, JButtons, and Tool Tips to a JFrame 


In addition to including JLabe1 objects, JFrames often contain other window features, such as 
JTextFields, JButtons, and tool tips. 


Adding JTextFields 


A JTextField is a component into which a user can type a single line of text data. (Text 
data comprises any characters you can enter from the keyboard, including numbers and 
punctuation.) Figure 14-19 shows the inheritance hierarchy of the JTextField class. 


Adding JTextFields, JButtons, and Tool Tips to a JFrame D0 





java.lang.Object 


+--java.awt.Component 


+--java.awt.Container 759 


+--javax.swing.JComponent 


+--javax.swing.text.JTextComponent 


+--javax.swing.JTextField 














Figure 14-19 The JTextField class inheritance hierarchy 


Typically, a user types a line into a JTextField and then presses Enter on the keyboard or 
clicks a button with the mouse to enter the data. You can construct a JTextField object 
using one of several constructors: 


e public JTextFieldQ constructs a new JTextField. 


e public JTextFieldCint columns) constructs a new, empty JTextField with a specified 
number of columns. 


e public JTextField(String text) constructs a new JTextField initialized with the 
specified text. 

e public JTextField(String text, int columns) constructs a new JTextField 
initialized with the specified text and columns. 


For example, to provide a JTextField that allows enough room for a user to enter 
approximately 10 characters, you can code the following: 


JTextField response = new JTextField(10); 
To add the JTextField named response to a JFrame named frame, you write: 
frame.add(response) ; 


The number of characters a JTextField can display depends on the font being used and the 
actual characters typed. For example, in most fonts, w is wider than i, so a JTextField of size 
10 using the Arial font can display 24 i characters, but only eight w characters. 


Try to anticipate how many characters your users might enter when you create a JTextField. 
The user can enter more characters than those that display, but the extra characters scroll out 
of view. It can be disconcerting to try to enter data into a field that is not large enough. It is 
usually better to overestimate than underestimate the size of a text field. 


Several other methods are available for use with JTextFields. The setText() method allows 
you to change the text in a JTextField (or other Component) that has already been created, as 
in the following: 


response.setText("Thank you"); 
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After a user has entered text in a JTextField, you can clear it out with a statement such as 
the following, which assigns an empty string to the text: 


response. setText("""); 


The getText() method allows you to retrieve the String of text in a JTextField (or other 
760 Component), as in: 





String whatUserTyped = response.getText() ; 


When a JTextField has the capability of accepting keystrokes, the JTextField is editable. 
A JTextField is editable by default. If you do not want the user to be able to enter data 

in a JTextField, you can send a boolean value to the setEditable() method to change 
the JTextField’s editable status. For example, if you want to give a user a limited number of 
chances to answer a question correctly, you can count data entry attempts and then prevent 
the user from replacing or editing the characters in the JTextField by using a statement 
similar to the following: 


if(attempts > LIMIT) 
response.setEditable(false) ; 


Adding JButtons 


A JButton is a Component the user can click with a mouse to make a selection. A JButton is 
even easier to create than a JTextField. There are five JButton constructors: 


e public JButton() creates a button with no set text. 
e public JButton(Icon icon) creates a button with an icon of type Icon or ImageIcon. 
e public JButton(String text) creates a button with text. 


e public JButton(String text, Icon icon) creates a button with initial text and an icon 
of type Icon or ImageIcon. 


e public JButton(Action a) creates a button in which properties are taken from the 
Action supplied. (Action is a Java class.) 


The inheritance hierarchy of the JButton class is shown in Figure 14-20. 


java.lang.Object 


+--java.awt.Component 


+--java.awt.Container 


+--javax.swing.JComponent 


+--javax.swing.AbstractButton 


+--javax.swing.JButton 
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To create a JButton with the label “Press when ready”, you can write the following: 
JButton readyJButton = new JButton("Press when ready"); 


You can add a JButton to a JFrame (or other container) using the add() method. You can 


change a JButton’s label with the setText() method, as in: 
761 








readyJButton.setText("Don't press me again!"); 


You can retrieve the text from a JButton and assign it to a String object with the getTextO 
method, as in: 


String whatsOnJButton = readyJButton.getText() ; 


Figure 14-21 shows a class that extends JFrame and holds several components. As the 
components (two JLabels, a JTextField, and a JButton) are added to the JFrame, they are 
placed from left to right in horizontal rows across the JFrame’s surface. Figure 14-22 shows 
the program that instantiates an instance of the JFrame. 


import javax.swing.*; 
import java.awt.*; 
public class JFramewithManyComponents extends JFrame 
{ 
final int FRAME_WIDTH = 300; 
final int FRAME_HEIGHT = 150; 
public JFrameWithManyComponents () 
{ 
super("Demonstrating many components") ; 
setSizeCFRAME_WIDTH, FRAME_HEIGHT) ; 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
JLabel heading = new JLabelC("This frame has many components"); 
heading.setFont(new Font("Arial", Font.BOLD, 16)); 
JLabel namePrompt = new JLabelC"Enter your name:"); 
JTextField nameField = new JTextField(12); 
JButton button = new JButtonC"Click to continue"); 
setLayout(new FlowLayout()); 
add(heading) ; 
add(namePrompt) ; 
add(CnameField); 
add(button) ; 





Figure 14-21 The JFramewithManyComponents class 
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public class ComponentDemo 


i 


public static void main(String[] args) 
{ 
JFramewithManyComponents frame = 
new JFrameWithManyComponents () ; 
frame.setVisible(true) ; 





Figure 14-22 A ComponentDemo application that instantiates a JFrameWithManyComponents 


When you execute the ComponentDemo program, the JFrame contains all the components that 
were added in the frame’s constructor, as shown in Figure 14-23. A user can minimize or 
restore the frame and can alter its size by dragging the frame borders. The user can type 
characters in the JTextField and click the JButton. When the button is clicked, it appears 
to be pressed just like buttons you have used in professional applications. However, when the 
user types characters or clicks the button, no resulting actions occur because code has not yet 
been written to handle those user-initiated events. 





fe 
|| Demonstrating many comp... 





This frame has many components 





Enter your name: | | 











| Click to continue 








Figure 14-23 Execution of the ComponentDemo program 


Using Tool Tips 


Tool tips are popup windows that can help a user understand the purpose of 
components in an application; the tool tip appears when a user hovers the mouse 
pointer over the component. You define the text to be displayed in a tool tip by using 
the setToolTipText() method and passing an appropriate String to it. For example, in 
the JFramewWithManyComponents program in Figure 14-21, you can add a tool tip to the 
button component by using the following statement in the JFrame constructor: 


button.setToolTipTextC"Click this button"); 


Figure 14-24 shows the result when the JFrame is displayed and the user’s mouse pointer is 
placed over the button. 
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|| Demonstrating many comp... So 


This frame has many components 





Enter your name: | | 














Click to corneas 763 


Click this button 





Figure 14-24 JFrame with added tool tip 


JFrameWithManyComponents with the tool tip added. The ToolTipDemo.java file contains an 


The JFrameWithToolTip.java file in your downloadable student files contains a revised version of 
GY application that instantiates a JFrameWithToolTip object. 


Adding JTextFields, JButtons, and Tool Tips to a JFrame 


1. A JTextField is a component into which a user can type a single line of text 
data; typically, a user types a line into a JTextField and then presses Enter on 
the keyboard or clicks a button with the mouse to enter the data. 


A JButton IS a Component the user can click with a mouse to make a selection. 


Tool tips are the different symbols you can select to display as a cursor in your 
applications. 
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v You Do It 


Adding Components to a JFrame 


Next, you create a Swing application that displays a JFrame that holds a JLabel, 
JTextField, and JButton. 


1. 


Open a new file in your text editor, then type the following first few lines of an 
application. The import statements make the Swing and AwT components 
available, and the class header indicates that the class is a JFrame. The class 
contains several components: a label, field, and button. 


import javax.swing.*; 
import java.awt.*; 
public class JFrameWithComponents extends JFrame 


{ 


JLabel label = new JLabel("Enter your name"); 
JTextField field = new JTextField(12); 
JButton button = new JButtonC("OK"); 


In the JFramewithComponents constructor, set the JFrame title to “Frame with 
Components” and the default close operation to exit the program when the 
JFrame is closed. Set the layout manager. Add the label, field, and button to 
the JFrame. 


public JFrameWithComponents() 
{ 
super ("Frame with Components") ; 
setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setLayout (new FlowLayout()); 
add(label); 
add(field); 
add(button) ; 
} 


Add a closing curly brace for the class, and then save the file as 
JFrameWithComponents.java. 


Compile the class and correct any errors. 


Next, write an application that creates a new JFramewithComponents named 
aFrame, sizes it using the setSize() method, and then sets Its visible property 
tO true. 


(continues) 
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(continued) 


import javax.swing.*; 

public class CreateJFrameWithComponents 

{ 765 
public static void main(String[] args) 


{ 








JFrameWithComponents aFrame = 
new JFrameWithComponents() ; 

final int WIDTH = 350; 

final int HEIGHT = 100; 

aFrame.setSize(WIDTH, HEIGHT) ; 

aFrame.setVisible(true) ; 


Hy 


6. Save the file as CreateJFrameWithComponents.java. Compile and then 
execute the application. The output is shown in Figure 14-25. 





|| Frame with Components 


Enter your name 





Figure 14-25 Output of the CreateJFramewWithComponents application 


7. Click the JButton. It acts like a button should—that is, it appears to be pressed 
when you click It, but nothing happens because you have not yet written 
instructions for the button clicks to execute. 


8. Close the application. 


Learning About Event-Driven Programming 


An event occurs when a user takes action on a component, such as clicking the mouse on a 
JButton object. In an event-driven program, the user might initiate any number of events in 
any order. For example, if you use a word-processing program, you have dozens of choices at 
your disposal at any time. You can type words, select text with the mouse, click a button to 
change text to bold, click a button to change text to italic, choose a menu item, and so on. 
With each word-processing document you create, you choose options in any order that 
seems appropriate at the time. The word-processing program must be ready to respond to 
any event you initiate. 
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Within an event-driven program, a component on which an event is generated is the source 
of the event. A button that a user can click is an example of a source; a text field that a user 
can use to enter text is another source. An object that is interested in an event is a listener. 
Not all objects listen for all possible events—you probably have used programs in which 
clicking many areas of the screen has no effect. If you want an object to be a listener for an 
766 event, you must register the object as a listener for the source. 





Social networking sites maintain lists of people in whom you are interested and notify you 
each time a person on your list posts a comment or picture. Similarly, a Java component 
source object (such as a button) maintains a list of registered listeners and notifies all of them 
when any event occurs. For example, a JFrame might want to be notified of any mouse click 
on its surface. When the listener “receives the news,” an event-handling method contained in 
the listener object responds to the event. 


A source object and a listener object can be the same object. For example, you might program a JButton 
GY to change its own label when a user clicks it. 


To respond to user events within any class you create, you must do the following: 
e Prepare your class to accept event messages. 
e Tell your class to expect events to happen. 


e Tell your class how to respond to events. 


Preparing Your Class to Accept Event Messages 


You prepare your class to accept button-press events by importing the java.awt.event 
package into your program and adding the phrase implements ActionListener to the class 
header. The java.awt.event package includes event classes with names such as 
ActionEvent, ComponentEvent, and TextEvent. ActionListener is an interface—a class 
containing a set of specifications for methods that you can use. Implementing 
ActionListener provides you with standard event method specifications that allow your 
listener to work with ActionEvents, which are the types of events that occur when a user 
clicks a button. 


ActionListener because they use the keyword implements. In ordinary language, an item that is 
implemented is put into service, or used. Implementation has a similar meaning when applied to interfaces. In 
contrast, packages that are imported are brought into an application, and classes that are added onto are 
extended. 


Q You learned to create and implement interfaces in Chapter 11. You can identify interfaces such as 
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Telling Your Class to Expect Events to Happen 


You tell your class to expect ActionEvents with the addActionListener() method. If you 

have declared a JButton named aButton, and you want to perform an action when a user 

clicks aButton, aButton is the source of a message, and you can think of your class as a target 

to which to send a message. You learned in Chapter 4 that the this reference means “this 767 
current object,” so the code aButton.addActionListener(this); causes any ActionEvent 
messages (button clicks) that come from aButton to be sent to “this current object.” 








KeyListeners have an addKeyListener() method, and FocusListeners have an 
addFocusListener() method. Additional event types and methods are covered in more 
detail in the next chapter. 


QG Not all Events are ActionEvents with an addActionListener() method. For example, 


Telling Your Class How to Respond to Events 


The ActionListener interface contains the actionPerformed(ActionEvent e) method 
specification. When a class, such as a JFrame, has registered as a listener with a Component 
such as a JButton, and a user clicks the JButton, the actionPerformed() method executes. 
You implement the actionPerformed() method, which contains a header and a body, like all 
methods. You use the following header, in which e represents any name you choose for the 
Event (the JButton click) that initiated the notification of the ActionListener (which is 
the JFrame): 


public void actionPerformed(ActionEvent e) 


The body of the method contains any statements that you want to execute when the action 
occurs. You might want to perform mathematical calculations, construct new objects, 
produce output, or execute any other operation. For example, Figure 14-26 shows a JFrame 
containing a JLabel that prompts the user for a name, a JTextField into which the user can 
type a response, a JButton to click, and a second JLabel that displays the name entered by 
the user. The actionPerformed() method executes when the user clicks the pressMe 
JButton; within the method, the String that a user has typed into the JTextField is 
retrieved and stored in the name variable. The name is then used as part of a String that alters 
the second JLabel on the JFrame. Figure 14-27 shows an application that instantiates a 
JHelloFrame object and makes it visible. 
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import javax.swing.*; 

import java.awt.*; 

import java.awt.event.*; 

public class JHelloFrame extends JFrame implements ActionListener 
768 { 





JLabel question = new JLabelC"What is your name?"); 
Font bigFont = new FontC"Arial", Font.BOLD, 16); 
JTextField answer = new JTextField(10); 

JButton pressMe = new JButton("Press me"); 

JLabel greeting = new JLabel(""); 

final int WIDTH = 275; 

final int HEIGHT = 225; 

public JHelloFrameQ) 

{ 


super("Hello Frame"); 
setSize(WIDTH, HEIGHT); 


setLayout(new FlowLayout()); 
question.setFont(bigFont) ; 
greeting.setFont(bigFont) ; 
add(question) ; 
add(answer) ; 
add(pressMe) ; 
add(greeting) ; 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
pressMe.addActionListener(this) ; 
} 
public void actionPerformed(ActionEvent e) 
{ 
String name = answer.getTextQ; 
String greet = "Hello, " + name; 
greeting.setText(greet) ; 





Figure 14-26 The JHelloFrame class that produces output when the user clicks the JButton 


public class JHelloDemo 
{ 
public static void main(String[] args) 


{ 


JHelloFrame frame = new JHelloFrame(); 
frame.setVisible(true) ; 





Figure 14-27 An application that instantiates a JHel 1oFrame object 
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Figure 14-28 shows a typical execution of the JHe11loDemo program. The user enters Lindsey 
into the JTextField, and the greeting with the name is displayed after the user clicks the 
button. 
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|5| Hello Frame || Hello Frame 














What is your name? 


|Lindsey Press me 


What is your name? 


Lindsey || Press me 


Hello, Lindsey 



































Figure 14-28 Typical execution of the JHel 1oDemo program 


When more than one component is added and registered to a JFrame, it might be necessary 
to determine which component was used to initiate an event. For example, in the 
JHelloFrame class in Figure 14-26, you might want the user to be able to see the message 
after either clicking the button or pressing Enter in the JTextField. In that case, you would 
designate both the pressMe button and the answer text field to be message sources by using 
the addActionListener() method with each, as follows: 


pressMe.addActionListener(this) ; 
answer.addActionListener(this) ; 


These two statements make the JFrame (this) the receiver of messages from either object. 
The JFrame has only one actionPerformed() method, so it is the method that executes when 
either the pressMe button or the answer text field sends a message. 


If you want different actions to occur depending on whether the user clicks the button or 
presses Enter, you must determine the source of the event. Within the actionPerformed() 
method, you can use the getSource() method of the object sent to determine which 
component generated the event. For example, within a method with the header public void 
actionPerformed(ActionEvent e), e is an ActionEvent. ActionEvent and other event 
classes are part of the java.awt.event package and are subclasses of the EventObject class. 
To determine what object generated the ActionEvent, you can use the following statement: 


Object source = e.getSource(); 


For example, if a JFrame contains two JButtons named option1 and option2, you can use the 
decision structure in the method in Figure 14-29 to take different courses of action based on 
the button that is clicked. Whether an event’s source is a JButton, JTextField, or other 
Component, it can be assigned to an Object because all components descend from Object. 
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public void actionPerformed(ActionEvent e) 


{ 


Object source = e.getSource(); 
if(source == option1) 


770 //execute these statements when user clicks optionl 
else 
//execute these statements when user clicks any other option 








Figure 14-29 An actionPerformed() method that takes one of two possible actions 


Alternatively, you can also use the instanceof keyword to determine the source of the event. 
The instanceof keyword is used when it is necessary to know only the component’s type, 
rather than what component triggered the event. For example, if you want to take some 
action when a user enters data into any JTextField, but not when an event is generated by a 


different Component type, you could use the method format shown in Figure 14-30. 


void actionPerformed(ActionEvent e) 
{ 
Object source = e.getSource(); 
if(source instanceof JTextField) 


{ 


// execute these statements when any JTextField 
// generates the event 
// but not when a JButton or other Component does 


z 





Figure 14-30 An actionPerformed() method that executes a block of statements when a user 


generates an event from any JTextField 


Using the setEnabled() Method 


You probably have used computer programs in which a component becomes disabled or 


unusable. For example, a JButton might become dim and unresponsive when the 


programmer no longer wants you to have access to the JButton’s functionality. Components 
are enabled by default, but you can use the setEnabled() method to make a component 
available or unavailable by passing true or false to it, respectively. For example, Figure 14-31 
shows a JFrame with two JButton objects. The one on top is enabled, but the one on the 


bottom has been disabled. 
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Figure 14-31 A JFrame with an enabled JButton and a disabled JButton 


Q Your downloadable student files contain a file named JTwoButtons.java that produces the JFrame shown in 
Figure 14-31. 


Learning About Event-Driven Programming 


1. Within an event-driven program, a component on which an event Is generated 
is a listener. 


2. You prepare your class to accept button-press events by importing the 
java.awt.event package into your program and adding the phrase 
implements ActionListener to the class header. 


3. Aclass that can react to ActionEvents includes an actionPerformed() 
method. 
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Q You Do It 


Adding Functionality to a JButton and a JTextField 
Next, you add functionality to the JButton and JTextField that you created in the 


JFrameWithComponents class. 


L 


Open the JFrameWithComponents.java file. Immediately save the file as 
JAction.java. 


After the existing import statements at the top of the file, add the following 
import statement that will allow event handling: 


import java.awt.event.*; 


Change the class name to JAction to match the new filename. Also change 
the constructor header to match the new class name. Within the constructor, 
change the string argument to the super@ method from “Frame with 
Components” to “Action”. 


After extends JFrame at the end of the JAction class header, add the 
following phrase so that the class can respond to ActionEvents: 


implements ActionListener 


Register the JAction class as a listener for events generated by either the 
button or the text field by adding the following statements at the end of, but 
within, the JAction® constructor: 


button. addActionListener(this); 
field.addActionListener(this) ; 


Just prior to the closing curly brace for the class, add the following 
actionPerformed() method. The method changes the text on both the label 
and the button whenever the user clicks the button or presses Enter in the text 
field. 


public void actionPerformed(ActionEvent e) 
{ 
label .setText("Thank you") ; 
button.setText("Done") ; 
} 


Just after the actionPerformed() method, and just before the closing curly 
brace for the class, add a mainQ method to the class so that you can 
instantiate a JAction object for demonstration purposes. 


(continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce 


earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 





Learning About Event-Driven Programming D0 








(continued) 
public static void main(String[] args) 
{ 
JAction aFrame = new JActionQ; 
final int WIDTH = 250; 773 
final int HEIGHT = 100; 
aFrame.setSize(WIDTH, HEIGHT) ; 
aFrame.setVisible(true); 
} 


8. Save the file, then compile and execute it. The output looks like the frame on the 
left side of Figure 14-32. Type a name in the text field, and then click the OK 
button. Its text changes to “Done”, and its size increases slightly because the 
label “Done” requires more space than the label “OK”. The other label requires 
less space than it did because “Thank you” is a shorter message than “Enter 
your name”. Therefore, all the components are redistributed because the 
FlowLayout manager places as many components as will fit horizontally in the 
top row before adding components to subsequent rows. The output looks like 
the right side of Figure 14-32. 














|| Action Sto || Action ro 
Enter your name Thank you [Emma 
Emma OK Done 
ly 
Figure 14-32 Typical execution of the JAction application after the user clicks the 
OK button 


9. Close the application and then execute it again. This time, enter a name in the 
text field and press Enter. Again, the button text changes, showing that the 
actionPerformed() method reacts to actions that take place on either the 
button or the text field. 


10. Close the application. 


Distinguishing Event Sources 


Next, you will modify the actionPerformed() method of the JAction class so that 
different results occur depending on which action a user takes. 


1. Open the JAction.java file in your text editor if the file is not still open. 
Immediately save the file as JAction2.java. 


(continues) 
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(continued) 


2. Change the class name and the constructor name to match the new filename by 
adding 2 to each name. 


774 3. In the main© method, change the statement that instantiates the JFrame object 
to the following: 





JAction2 aFrame = new JAction2(); 


4. Within the actionPerformed() method, you can use the named ActionEvent 
argument and the getSource() method to determine the source of the event. 
Using an if statement, you can take different actions when the argument 
represents different sources. For example, you can change the label in the frame 
to indicate the event’s source. Change the actionPerformed() method to: 


public void actionPerformed(ActionEvent e) 


{ 
Object source = e.getSource() ; 
if (source == button) 
label .setText ("You clicked the button") ; 
else 
label .setText(""You pressed Enter"); 
} 


5. Save the file (as JAction2.java), then compile and execute it. Type a name, press 
Enter or click the button, and notice the varying results in the frame’s label. For 
example, Figure 14-33 shows the application after the user has typed a name 
and pressed Enter. 





S| Action S | ©) [meso 





You pressed Enter 


[Emma || OK | 














Figure 14-33 Typical execution of the JAction2 application 


6. Close the application. 


Understanding Swing Event Listeners 


Many types of listeners exist in Java, and each of these listeners can handle a specific event 
type. A class can implement as many event listeners as it needs—for example, a class might 
need to respond to both a mouse button press and a keyboard key press, so you might 
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Understanding Swing Event Listeners.) 


implement both ActionListener and KeyListener interfaces. Table 14-2 lists some event 
listeners and the types of events for which they are used. 











Listener Type of Events Example 
ActionListener Action events Button clicks 7715 
AdjustmentListener Adjustment events Scroll bar moves 
ChangeListener Change events Slider is repositioned 
FocusListener Keyboard focus events Text field gains or 
loses focus 
ItemListener Item events Check box changes 
status 
KeyListener Keyboard events Text is entered 
MouseListener Mouse events Mouse clicks 
MouseMotionListener Mouse movement events Mouse rolls 
WindowListener Window events Window closes 


Ve) 54 = Alphabetical list of some event listeners 


An event occurs every time a user types a character or clicks a mouse button. Any object can 
be notified of an event as long as it implements the appropriate interface and is registered as 
an event listener on the appropriate event source. You already know that you establish a 
relationship between a JButton and a JFrame that contains it by using the 
addActionListener() method. Similarly, you can create relationships between other Swing 
components and the classes that react to users’ manipulations of them. In Table 14-3, each 
component listed on the left is associated with a method on the right. For example, when you 
want a JCheckBox to respond to a user’s clicks, you can use the addItemListener() method 
to register the JCheckBox as the type of object that can create an ItemEvent. The argument 
you place within the parentheses of the call to the addItemListener() method is the object 
that should respond to the event—perhaps a JFrame that contains the event-generating 
JCheckBox. The format is: 


theSourceOfTheEvent.addListenerMethod(theClassThatShouldRespond) ; 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 14 Introduction to Swing Components 


Component(s) Associated Listener-Registering Method(s) 
JButton, JCheckBox, JComboBox, JTextField, addActionListener() 

and JRadioButton 

JScrol1Bar addAdjustmentListener() 





776 





All Swing components addFocusListener(), addKeyListener(), 
addMouseListenerQ, and 
addMouseMotionListener() 


JButton, JCheckBox, JComboBox, and addItemListener() 
JRadioButton 

All JWindow and JFrame components addwindowListener() 
JSlider and JCheckBox addChangeListener() 


He) (Ee) Some Swing components and their associated listener-registering methods 


with multiple event sources. In other words, a single instance of JCheckBox might generate ItemEvents 
and FocusEvents, and a single instance of the JFrame class might respond to ActionEvents 
generated by a JButton and ItemEvents generated by a JCheckBox. 


Q Any event source can have multiple listeners registered on it. Conversely, a single listener can be registered 


The class of the object that responds to an event must contain a method that accepts the 
event object created by the user’s action. A method that executes because it is called 
automatically when an appropriate event occurs is an event handler. In other words, when 
you register a component (such as a JFrame) to be a listener for events generated by another 
component (such as a JCheckBox), you must write an event handler method. You cannot 
choose your own name for event handlers—specific method identifiers react to specific event 
types. Table 14-4: lists just some of the methods that react to events. 





Listener Method 

ActionListener actionPerformed(ActionEvent) 

AdjustmentListener adjustmentValueChanged (AdjustmentEvent) 
FocusListener focusGained(FocusEvent) and focusLost (FocusEvent) 
ItemListener itemStateChanged(ItemEvent) 


Ve\)5 Selected methods that respond to events 


KeyListener and MouseListener, are associated with multiple methods. You will learn how to use 


Each listener in Table 14-4 is associated with only one or two methods. Other listeners, such as 
Y these more complicated listeners in the chapter Advanced GUI Topics. 
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Understanding Swing Event Listeners 


Until you become familiar with the event-handling model, it can seem quite confusing. For 
now, remember these tasks you must perform when you declare a class that handles an event: 


e The class that handles an event must either implement a listener interface or extend a 
class that implements a listener interface. For example, if a JFrame named MyFrame needs 


to respond to a user’s clicks on a JCheckBox, you would write the following class header: 777 








public class MyFrame extends JFrame 
implements ItemListener 


If you then declare a class that extends MyFrame, you need not include implements 
ItemListener in its header. The new class inherits the implementation. 


e You must register each instance of the event-handling class as a listener for one or more 
components. For example, if MyFrame contains a JCheckBox named myCheckBox, then 
within the MyFrame class you would code: 


myCheckBox.addItemListener (this) ; 
The this reference is to the class in which myCheckBox is declared—in this case, MyFrame. 


e You must write an event handler method with an appropriate identifier (as shown in 
Table 14-4) that accepts the generated event and reacts to it. 


ee 
=" Watch the video Event-Driven Programming. 


Understanding Swing Event Listeners 


1. Aclass can implement as many event listeners as it needs. 


2. Any object can be notified of a mouse click or keyboard press as long as it 
implements the appropriate interface and is registered as an event listener on 
the appropriate event source. 


3. Every eventhandling method accepts a parameter that represents the listener 
for the event. 
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Using the JCheckBox, ButtonGroup, and JComboBox 
Classes 


Besides JButtons and JTextFields, several other Java components allow a user to 
make selections in a UI environment. These include JCheckBoxes, ButtonGroups, 
778 and JComboBoxes. 





The JCheckBox Class 


A JCheckBox consists of a label positioned beside a square; you can click the square to display 
or remove a check mark. Usually, you use a JCheckBox to allow the user to turn an option on 
or off. For example, Figure 14-34 shows the code for an application that uses four 
JCheckBoxes, and Figure 14-35 shows the output. 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 
public class CheckBoxDemonstration 
extends JFrame implements ItemListener 
{ 
FlowLayout flow = new FlowLayout(); 
JLabel label = new JLabelC"What would you like to drink?"); 
JCheckBox coffee = new JCheckBox("Coffee", false); 
JCheckBox cola = new JCheckBox("Cola", false); 
JCheckBox milk = new JCheckBox("Milk", false); 
JCheckBox water = new JCheckBox("Water", false); 
String output, insChosen; 
public CheckBoxDemonstration() 
{ 
super("CheckBox Demonstration") ; 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setLayout(new FlowLayout()); 
label.setFont(new FontC"Arial", Font.ITALIC, 22)); 
coffee.addItemListener(this); 
cola.addItemListener(this) ; 
milk.addItemListener(this); 
water.addItemListener(this) ; 
add(label); 
add(coffee) ; 
add(cola); 
add(milk); 
add (water) ; 





Figure 14-34 The CheckBoxDemonstration class (continues) 
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(continued) 


public void itemStateChanged(ItemEvent check) 
{ 

// Actions based on choice go here 
} . . . . . 779 
public static void main(String[] arguments) 


{ 








final int FRAME_WIDTH = 350; 


final int FRAME_HEIGHT = 120; 
CheckBoxDemonstration frame = 

new CheckBoxDemonstrationQ ; 
frame.setSize(FRAME_ WIDTH, FRAME _HEIGHT) ; 
frame.setVisible(true) ; 





Figure 14-34 The CheckBoxDemonstration class 


instantiates an instance of it are part of the same class. You could also store the two parts in separate 


In the application in Figure 14-34, the CheckBoxDemonstration class and the main() method that 
YD classes, as in previous examples. 





7 
|| CheckBox Demonstration 


What would you like to drink? 





|_]Coffee [_|Cola [_] Milk | Water 














Figure 14-35 Output of the CheckBoxDemonstration class 


The inheritance hierarchy of the JCheckBox class is shown in Figure 14-36; frequently used 
JCheckBox methods appear in Table 14-5. 





java.lang.Object 
+--Java.awt .Component 
+--Java.awt.Container 
+--javax.swing.JComponent 
!__javax.swing.AbstractButton 
+--javax.swing.JToggleButton 
+--Javax.swing.JCheckBox 








Figure 14-36 The inheritance hierarchy of the JCheckBox class 
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Method Purpose 
void setText(String) Sets the text for the JCheckBox 
String getTextQ) Returns the JCheckBox text 
780 void setSelected(boolean) Sets the state of the JCheckBox to true for selected or false 
for unselected 
boolean isSelected() Gets the current state (checked or unchecked) of the 
JCheckBox 


We) (eS) Frequently used JCheckBox methods 


Several constructors can be used with JCheckBoxes. When you construct a JCheckBox, you 
can choose whether to assign it a label; you can also decide whether the JCheckBox appears 
selected (JCheckBoxes start unselected by default). The following statements create four 
JCheckBox objects—one with no label and unselected, two with labels and unselected, and 
one with a label and selected. 


e JCheckBox box1 = new JCheckBox(); 
// No label, unselected 


e JCheckBox box2 = new JCheckBox("Check here"); 
// Label, unselected 


e JCheckBox box3 = new JCheckBox("Check here", false); 
// Label, unselected 


e JCheckBox box4 = new JCheckBox("Check here", true); 
// Label, selected 


If you do not initialize a JCheckBox with a label and you want to assign one later, or if you 
want to change an existing label, you can use the setText() method, as in the following 
example: 


box1.setTextC"Check this box now"); 


You can set the state of a JCheckBox with the setSelected() method; for example, you can 
use the following statement to ensure that box1 is unchecked: 


box1.setSelected(false); 


The isSelected() method is most useful in Boolean expressions, as in the following example, 
which adds one to a voteCount variable if box2 is currently checked. 


if (box2.isSelected()) 
++voteCount; 


When the status of a JCheckBox changes from unchecked to checked (or from checked to 
unchecked), an ItemEvent is generated, and the itemStateChanged() method executes. You 
can use the getItem() method to determine which object generated the event and the 
getStateChange() method to determine whether the event was a selection or a deselection. 
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The getStateChange() method returns an integer that is equal to one of two class 
variables—ItemEvent . SELECTED or ItemEvent .DESELECTED. For example, in Figure 14-37 the 
itemStateChanged() method calls the getItem() method, which returns the object named 
source. Then, the value of source is tested in an if statement to determine if it is equivalent 
to a JCheckBox object named checkBox. If the two references are to the same object, the code 
determines whether the checkBox was selected or deselected, and in each case appropriate 781 
actions are taken. 








public void itemStateChanged(ItemEvent e) 
{ 
Object source = e.getItem(); 
ifCsource == checkBox) 
{ 
int select = e.getStateChange() ; 
if(select == ItemEvent.SELECTED) 
// statements that execute when the box is checked 
else 
// statements that execute when the box is unchecked 
} 
else 


{ 


// statements that execute when the source of the event is 
// some component other than the checkBox object 





Figure 14-37 Typical itemStateChanged() method 


The ButtonGroup Class 


Sometimes, you want options to be mutually exclusive—that is, you want the user to be able 
to select only one of several choices. When you create a ButtonGroup, you can group several 
components, such as JCheckBoxes, so a user can select only one at a time. When you group 
JCheckBox objects, all of the other JCheckBoxes are automatically turned off when the user 

selects any one check box. The inheritance hierarchy for the ButtonGroup class is shown in 
Figure 14-38. You can see that ButtonGroup descends directly from the Object class. Even 

though it does not begin with a /, the ButtonGroup class is part of the javax.swing package. 





java.lang.Object 
+--Jjavax.swing.ButtonGroup 





Figure 14-38 The inheritance hierarchy for the ButtonGroup class 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





CHAPTER 14 Introduction to Swing Components 


(for example, those used to select preset radio stations on an automobile radio), which you can create using 

the JRadioButton class. The JRadioButton class is very similar to the JCheckBox class, and you 

might prefer to use it when you have a list of mutually exclusive user options. It makes sense to use 

ButtonGroups with items that can be selected (that is, those that use an isSelected() method). You 
782 can find more information about the JRadioButton class at http://java.sun.com. 


Q A group of JCheckBoxes in which a user can select only one at a time also acts like a set of radio buttons 





To create a ButtonGroup in a JFrame and then add a JCheckBox, you must perform four steps: 
e Create a ButtonGroup, such as ButtonGroup aGroup = new ButtonGroup() ;. 

e Create a JCheckBox, such as JCheckBox aBox = new JCheckBox();. 

e Add aBox to aGroup with aGroup.add(aBox) ;. 

e Add aBox to the JFrame with add(aBox) ;. 


You can create a ButtonGroup and then create the individual JCheckBox objects, or you can 
create the JCheckBoxes and then create the ButtonGroup. If you create a ButtonGroup but 
forget to add any JCheckBox objects to it, then the JCheckBoxes act as individual, 
nonexclusive check boxes. 


A user can set one of the JCheckBoxes within a group to “on” by clicking it with the mouse, or 
the programmer can select a JCheckBox within a ButtonGroup with a statement such as the 
following: 


aGroup.setSelected(aBox) ; 


Only one JCheckBox can be selected within a group. If you assign the selected state to a 
JCheckBox within a group, any previous assignment is negated. 


You can determine which, if any, of the JCheckBoxes in a ButtonGroup is selected using the 
isSelected() method. 


After a JCheckBox in a ButtonGroup has been selected, one in the group will always be 
selected. In other words, you cannot “clear the slate” for all the items that are members of a 
ButtonGroup. You could cause all the JCheckBoxes in a ButtonGroup to initially appear 
unselected by adding one JCheckBox that is not visible (using the setVisible() method). 
Then, you could use the setSelected() method to select the invisible JCheckBox, and all the 
others would appear to be deselected. 


The JComboBox Class 


A JComboBox is a component that combines two features: a display area showing a default 
option and a list box that contains additional, alternate options. (A list box is also known as a 
combo box or a drop-down list.) The display area contains either a button that a user can 
click or an editable field into which the user can type. When a JComboBox appears on the 
screen, the default option is displayed. When the user clicks the JComboBox, a list of 
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alternative items drops down; if the user selects one, it replaces the box’s displayed item. 
Users often expect to view JComboBox options in alphabetical order. If it makes sense for your 
application, consider displaying your options this way. Other reasonable approaches are to 
place choices in logical order, such as “small”, “medium”, and “large”, or to position the most 


frequently selected options first. 
783 








Figure 14-39 shows a JComboBox as it looks when first displayed and as it looks after a user 
clicks it. The inheritance hierarchy of the JComboBox class is shown in Figure 14-40. 











Figure 14-39 A JComboBox before and after the user clicks it 


The code that produces the JComboBox in Figure 14-39 is contained in the file named 
GD ComboBoxDemonstration.java in your downloadable student files. 





java.lang.Object 
+-- JjJava.awt.Component 
+--java.awt.Container 
pes javax.swing.JComponent 
1__4javax. swing. IJComboBox 





Figure 14-40 The inheritance hierarchy of the JComboBox class 


You can build a JComboBox by using a constructor with no arguments and then adding items 
(for example, Strings) to the list with the addItem() method. The following statements 
create a JComboBox named majorChoice that contains three options from which a user can 
choose: 


JComboBox<String> majorChoice = new JComboBox<String>() ; 
majorChoice.addItem("English"); 
majorChoice.addItem("Math") ; 
majorChoice.addItem("Sociology") ; 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 14 Introduction to Swing Components 


In the declaration of the JComboBox, notice the use of <String> following the class name. By 
default, a JComboBox expects items that are added to be Object types. Adding the angle 
brackets and String notifies the compiler of the expected items in the JComboBox and allows 
the compiler to check for errors if invalid items are added. If you do not insert a data type for 
a JComboBox, the program compiles, but a warning message is issued with each addItem() 
method call. Programmers say that JComboBox uses generics. Generic programming is a 
feature of modern languages that allows multiple data types to be used safely with methods. 


784 





As an alternative, you can construct a JComboBox using an array of Objects as the constructor 
argument; the Objects in the array become the listed items within the JComboBox. For 
example, the following code creates the same majorChoice JComboBox as the preceding code: 


String[] majorArray = {"English", "Math", "Sociology"}; 
JComboBox majorChoice = new JComboBox(majorArray) ; 


Table 14-6 lists some methods you can use with a JComboBox object. For example, you can use 
the setSelectedItem() or setSelectedIndex() method to choose one of the items in a 
JComboBox to be the initially selected item. You also can use the getSelectedItem() or 
getSelectedIndex() method to discover which item is currently selected. 


Method 


Purpose 





void addItem(Object) 
void removeltem(Object) 
void removeAl lItems() 


Object getItemAt Cint) 


int getItemCountQ 


int getMaximumRowCount () 


int getSelectedIndex() 
Object getSelectedItem() 
Object[] getSelectedObjects( 
void setEditable(boolean) 


void setMaximumRowCount (int) 


void setSelectedIndex (int) 


void setSelectedItem(Object) 


Adds an item to the list 
Removes an item from the list 
Removes all items from the list 


Returns the list item at the index position specified by the 
integer argument 


Returns the number of items in the list 


Returns the maximum number of items the combo box can 
display without a scroll bar 


Returns the position of the currently selected item 
Returns the currently selected item 

Returns an array containing selected Objects 
Sets the field to be editable or not editable 


Sets the number of rows in the combo box that can be 
displayed at one time 


Sets the index at the position indicated by the argument 


Sets the selected item in the combo box display area to be 
the Object argument 


Vel) Some JComboBox class methods 
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You can treat the list of items in a JComboBox object as an array; the first item is at position 0, 
the second is at position 1, and so on. It is convenient to use the getSelectedIndexQ 
method to determine the list position of the currently selected item; then you can use the 
index to access corresponding information stored in a parallel array. For example, if a 
JComboBox named historyChoice has been filled with a list of historical events, such as 
“Declaration of Independence,” “Pearl Harbor,” and “Man walks on moon,” you can code the 785 
following to retrieve the user’s choice: 








int positionOfSelection = historyChoice.getSelectedIndex() ; 


The variable positionOfSelection now holds the position of the selected item, and 
you can use the variable to access an array of dates so you can display the date that 
corresponds to the selected historical event. For example, if you declare the following, 
then dates[positionOfSelection] holds the year for the selected historical event: 


int[] dates = {1776, 1941, 1969}; 


display the results of the toString() method used with those objects. In other words, instead of using 
parallel arrays to store historical events and dates, you could design a HistoricalEvent class that 
encapsulates Strings for the event and ints for the date. 


Q A JComboBox does not have to hold items declared as Strings; it can hold an array of Objects and 


In addition to JComboBoxes for which users click items presented in a list, you can create 
JComboBoxes into which users type text. To do this, you use the setEditable() method. A 
drawback to using an editable JComboBox is that the text a user types must exactly match an 
item in the list box. If the user misspells the selection or uses the wrong case, no valid value is 
returned from the getSelectedIndex() method. You can use an if statement to test the 
value returned from getSelectedIndex(); if it is negative, the selection did not match any 
items in the JComboBox, and you can issue an appropriate error message. 


Using the JCheckBox, ButtonGroup, and JComboBox Classes 
1. A JCheckBox consists of a label positioned beside a square; you can click the 
square to display or remove a check mark. 


2. When you create a ButtonGroup, you can group several components, such as 
JCheckBoxes, SO a user can Select multiple options simultaneously. 


3. When a user clicks a JComboBox, a list of alternative items drops down; if the 
user selects one, it replaces the box’s displayed item. 
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aN You Do It 


Including JCheckBoxes in an Application 
786 





Next, you create an interactive program for a resort. The base price for a room is 
$200, and a guest can choose from several options. Reserving a room for a 
weekend night adds $100 to the price, including breakfast adds $20, and including a 
round of golf adds $75. A guest can select none, some, or all of these premium 
additions. Each time the user changes the option package, the price is recalculated. 


1. Open a new file in your text editor, then type the following first few lines of a 
Swing application that demonstrates the use of a JCheckBox. Note that the 
JResortCalculator Class implements the ItemListener interface: 


import javax.swing.*; 

import java.awt.*; 

import java.awt.event.*; 

public class JResortCalculator extends 
JFrame implements ItemListener 


{ 


2. Declare the named constants that hold the base price for a resort room and 
the premium amounts for a weekend stay, including breakfast and a round of 
golf. Also include a variable that holds the total price for the stay, and initialize 
it to the value of the base price. Later, depending on the user’s selections, 
premium fees might be added to totalPrice, making it more than 
BASE_PRICE. 


final int BASE_PRICE = 200; 
final int WEEKEND PREMIUM = 100; 
final int BREAKFAST_PREMIUM = 20; 
final int GOLF_PREMIUM = 75; 
int totalPrice = BASE_PRICE; 


3. Declare three JCheckBox objects. Each is labeled with a String that contains 
a description of the option and the cost of the option. Each JCheckBox starts 
unchecked or deselected. 


JCheckBox weekendBox = new JCheckBox 

C'Weekend premium $" + WEEKEND PREMIUM, false); 
JCheckBox breakfastBox = new 

ICheckBox("Breakfast $" + BREAKFAST_PREMIUM, false); 
JCheckBox golfBox = new JCheckBox 

C'Golf $" + GOLF_PREMIUM, false); 


(continues) 
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(continued) 


4. Include jJLabels to hold user instructions and information and a JTextField in 
which to display the total price: 


JLabel resortLabel = new JLabel 787 


C"Resort Price Calculator"); 
JLabel ePrice = new JLabel("The price for your stay is"); 
JTextField totPrice = new JTextField(4); 
JLabel optionExplainLabel = new JLabel 
C'Base price for a room is $" 
+ BASE_PRICE + "."); 
JLabel optionExplainLabel2 = new JLabel 
C"Check the options you want."); 








5. Begin the JResortCalculator Class constructor. Include instructions to set the 
title by passing it to the JFrame parent class constructor, to set the default close 
operation, and to set the layout manager. Then add all the necessary 
components to the JFrame. 


public JResortCalculator() 

{ 
super("Resort Price Estimator") ; 
setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setLayout(new FlowLayout()) ; 
add(resortLabel) ; 
add(optionExplainLabel) ; 
add(optionExplainLabel 2) ; 
add(weekendBox) ; 
add(breakfastBox) ; 
add(gol fBox) ; 
add(priceLabel1) ; 
add(totPrice) ; 


6. Continue the constructor by setting the text of the totPrice JTextField to 
display a dollar sign and the totalPrice value. Register the class as a listener 
for events generated by each of the three JCheckBoxes. Finally, add a closing 
curly brace for the constructor. 


totPrice.setText("$" + totalPrice); 
weekendBox .addItemListener(this) ; 
breakfastBox.addItemListener(this) ; 
gol fBox.addItemListener(this) ; 


(continues) 
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(continued) 


7. Begin the itemStateChanged() method that executes when the user selects or 
deselects a JCheckBox. Use the appropriate methods to determine which 
788 JCheckBox is the source of the current ItemEvent and whether the event was 
generated by selecting a JCheckBox or by deselecting one. 





public void itemStateChanged(ItemEvent event) 
{ 


Object source = event.getSource() ; 
int select = event.getStateChange(); 


8. Write a nested if statement that tests whether the source is equivalent to the 
weekendBox, breakfastBox, or, by default, the gol fBox. In each case, depending 
on whether the item was selected or deselected, add or subtract the 
corresponding premium fee from the totalPrice. Display the total price in the 
JTextField, and add a closing curly brace for the method. 


if(source == weekendBox) 
if(select == ItemEvent.SELECTED) 
totalPrice += WEEKEND PREMIUM; 


else 
totalPrice -= WEEKEND PREMIUM; 
else if(source == breakfastBox) 


{ 
if(select == ItemEvent.SELECTED) 
totalPrice += BREAKFAST_PREMIUM; 
else 
totalPrice -= BREAKFAST_PREMIUM; 
} 
else // ifCsource == golfBox) by default 
if(select == ItemEvent.SELECTED) 
totalPrice += GOLF_PREMIUM; 
else 
totalPrice -= GOLF_PREMIUM; 
totPrice.setText("$" + totalPrice); 


E 


9. Add amainQ® method that creates an instance of the JFrame and sets its size 
and visibility. Then add a closing curly brace for the class. 


public static void main(String[] args) 
{ 
JResortCalculator aFrame = 
new JResortCalculator(; 
final int WIDTH = 300; 
final int HEIGHT = 200; 
aFrame.setSize(WIDTH, HEIGHT); 
aFrame.setVisible(true); 


} (continues) 
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Using the JCheckBox, ButtonGroup, and JComboBox Classes D0 


(continued) 


10. Save the file as JResortCalculator.java. Compile and execute the application. 
The output appears in Figure 14-41 with the base price initially set to $200. 


r 789 
|| Resort Price Estimator 











Resort Price Calculator 
Base price for aroom is $200. 
Check the options you want. 








Weekend premium $100 Breakfast $20 


Golf $75 The price for your stay is |$200 





























Figure 14-41 Initial output of the JResortCalculator application 


11. Select the Weekend premium JCheckBox, and note the change in the total 
price of the event. Experiment with selecting and deselecting options to ensure 
that the price changes correctly. For example, Figure 14-42 shows the 
application with the weekend and golf options selected, adding a total of $175 to 
the $200 base price. After testing all the option combinations, close the 
application. 





|| Resort Price Estimator 


Resort Price Calculator 
Base price for aroom is $200. 
Check the options you want. 














Weekend premium $100 (_| Breakfast $20 


Golf $75 The price for your stayis ($375 














Figure 14-42 Output of the JResortCalculator application after the user has made 
selections 
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Don't Do It 


e Don't forget the x in javax when you import Swing components into an application. 


e Don't forget to use a JFrame’s setVisible() method if you want the JFrame to be visible. 


790 e Don't forget to use setLayout() when you add multiple components to a JFrame. 





e Don't forget to call validate() and repaint() after you add or remove a component 
from a container that has been made visible. 


e Don't forget that the ButtonGroup class does not begin with a /. 





Key Terms 


Ul components are user interface components, such as buttons and text fields, with which the 
user can interact. 


Swing components are UI elements such as dialog boxes and buttons; you can usually 
recognize their names because they begin with /. 


Java Foundation Classes, or JFC, include Swing component classes and selected classes from 
the java.awt package. 


Lightweight components are written completely in Java and do not have to rely on the code 
written to run the local operating system. 


Heavyweight components require interaction with the local operating system. 


A container is a type of component that holds other components so you can treat a group 
of them as a single entity. Often, a container takes the form of a window that you can drag, 
resize, minimize, restore, and close. 


A JFrame is a container with a title bar and border. 









Pixels are the picture elements, or tiny dots of light, that make up the image on your 
computer monitor. 


Window decorations are the icons and buttons that are part of a window or frame. 
A look and feel is the default appearance and behavior of any user interface. 
JLabel is a built-in Java Swing class that holds text you can display. 

The addQ) method adds components to a container. 


The remove() method removes components from a container. 
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The setText() method allows you to change the text in a Component that has already been 
created. 


The getText() method allows you to retrieve the String of text in a Component. 


The Font class holds typeface and size information. 
791 








The setFont() method changes a JLabel’s font. 


The typeface argument to the Font constructor is a String representing a font. Common 
fonts have names such as Arial, Century, Monospaced, and Times New Roman. 


The style argument to the Font constructor applies an attribute to displayed text and is one 
of three values: Font.PLAIN, Font.BOLD, or Font. ITALIC. 


The point size argument to the Font constructor is an integer that represents about 1/72 of 
an inch. 


A layout manager is a class that controls component positioning. 
A BorderLayout is a layout manager that divides a container into regions. 


The flow layout manager places components in a row, and when a row is filled, components 
automatically spill into the next row. By default, the components in each row are centered. 


A JTextField is a component into which a user can type a single line of text data. 
Editable describes a component that can accept keystrokes. 

The setEditable() method changes the editable status of a JTextField. 

A JButton is a Component the user can click with a mouse to make a selection. 


Tool tips are popup windows that can help a user understand the purpose of components in 
an application; a tool tip appears when a user hovers the mouse pointer over the component. 


The setToolTipText() method defines the text to be displayed in a tool tip. 
An event occurs when a user takes action on a component. 
In an event-driven program, the user might initiate any number of events in any order. 


The source of an event is the component on which an event is generated. 










A listener is an object that is interested in an event. 
You tell a class to expect ActionEvents with the addActionListener() method. 


The actionPerformed(ActionEvent e) method specification defines the actions that occur in 
response to an event. 


The setEnabled() method makes a component available or dimmed and unavailable. 


An event handler is a method that executes because it is called automatically when an 
appropriate event occurs. 
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A JCheckBox consists of a label positioned beside a square; you can click the square to display 
or remove a check mark. Usually, you use a JCheckBox to allow the user to turn an option on 
or off. 
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A ButtonGroup groups several components, such as JCheckBoxes, so a user can select only 
one at a time. 


A JComboBox is a component that combines two features: a display area showing a default 
option and a list box containing additional options. The display area contains either a button 
that a user can click or an editable field into which the user can type. 


Generic programming is a feature of languages that allows methods to be used safely with 
multiple data types. 


Chapter Summary 


Swing components are UI elements such as dialog boxes and buttons. Each Swing 
component is a descendant of a JComponent, which in turn inherits from the 
java.awt.Container class. Swing components usually are placed in a container—a 

type of component that holds other components. Containers are defined in the Container 
class. Often, a container takes the form of a window that you can drag, resize, 
minimize, restore, and close. 


A JFrame holds and displays other objects. Useful methods include setSize(), 
setTitleQ, setVisibleQ, setBounds(), and setDefaultCloseOperation(). JFrames 
include a title bar at the top containing text information, and Minimize, Maximize or 
Restore, and Close buttons in the frame’s upper-right corner. When a user closes a JFrame 
by clicking the Close button in the upper-right corner, the default behavior is for the 
JFrame to become hidden and for the application to keep running. 


JLabel is a built-in Java Swing class that holds text you can display. You then can add a 
jLabel to a JFrame using the add() method. The setFont() method changes the font 
typeface, style, and point size. 


To place multiple components at specified positions in a container so they do not hide 
each other, you must use a layout manager—a class that controls component positioning. 
The normal (default) behavior of a JFrame is to use a layout format named BorderLayout. 
When you use FlowLayout, components do not lie on top of each other. Instead, 
components are placed in a row, and when a row is filled, components automatically spill 
into the next row. 


The advantage of creating a child class of JFrame is that you can set the JFrame’s 
properties within your object’s constructor; then, when you create your JFrame child 
object, it is automatically endowed with the features you have specified, such as title, size, 
and default close operation. 
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e A JTextField is a component into which a user can type a single line of text data. A 
JButton is a Component the user can click with a mouse to make a selection. Tool tips are 
popup windows that can help a user understand the purpose of components in an 
application; the tool tip appears when a user hovers the mouse pointer over the 


component. 
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e Within an event-driven program, a component on which an event is generated is the 
source of the event. An object that is interested in an event is a listener. You prepare your 
class to accept button-press events by importing the java. awt.event package into your 
program and adding the phrase implements ActionListener to the class header. You tell 
your class to expect ActionEvents with the addActionListener() method. The 
ActionListener interface contains the actionPerformed(ActionEvent e) method 
specification. You implement this method with the actions that should occur in response 
to the event. Within the actionPerformed() method, you can use the getSource() 
method of the object sent to determine which component generated the event. 


e <class can implement as many event listeners as it needs. Examples of event listeners are 
ActionListener, ItemListener, KeyListener, and MouseListener. Any object can be 
notified of an event as long as it implements the appropriate interface and is registered as 
an event listener on the appropriate event source. To add a listener method to a source, 
you must use the appropriate designated add() method. Specific methods react to specific 
event types; they include actionPerformed() and itemStateChanged(). 


e A JCheckBox consists of a label positioned beside a square; you can click the square to 
display or remove a check mark. Usually, you use a JCheckBox to allow the user to turn an 
option on or off. A ButtonGroup groups components so a user can select only one at a 
time. After a JCheckBox in a ButtonGroup has been selected, one in the group will always 
be selected. A JComboBox is a component that combines two features: a display area 
showing a default option and a list box containing additional options. You can treat the list 
of items in a JComboBox object as an array and use the getSelectedIndex() method to 
determine the list position of the currently selected item. 


Review Questions 


1. A JFrame is a descendant of each of the following classes except the 











class. 
a. Component c. Container 
b. Jar d. Window 


2. A programmer might prefer using a JFrame instead of a Window because, unlike a 
window, a JFrame 


a. can hold other objects c. can have descendants 
b. can be made visible d. has a title bar and border 
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3. The statement JFrame myFrame = new JFrame(); creates a JFrame that 


is 
a. invisible and has no title c. visible and has no title 
b. invisible and has a title d. visible and has a title 
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4. To create a JFrame named aFrame that is 300 pixels wide by 200 pixels tall, you 
can 
a. use the declaration JFrame aFrame = new JFrame(300, 200); 
declare a JFrame named aFrame and then code aFrame.setSize(300, 200); 


declare a JFrame named aFrame and then code aFrame.setBounds (300, 
200); 


d. use any of the above 


5. When a user closes a JFrame, the default behavior is for 


a. the JFrame to close and the application to keep running 

b. the JFrame to become hidden and the application to keep running 
c. the JFrame to close and the application to exit 

d. nothing to happen 


6. An advantage of extending the JFrame class is 


a. you can set the child class properties within the class constructor 

b. there is no other way to cause an application to close when the user clicks a 
JFrame’s Close button 

c. there is no other way to make a JFrame visible 


d. all of the above 


7. Suppose that you create an application in which you instantiate a JFrame named 
frame and a JLabel named label11. Which of the following statements within the 
application adds labe11 to frame1? 

a. labell.add(framel1) ; c. this.add(label1); 
b. framel.add(label1); d. two of the above 








8. The arguments required by the Font constructor include all of the following 
except 


a. typeface c. mode 
b. style d. point size 
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10. 


11. 


12. 


13. 


14. 


15. 
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A class that controls component positioning in a JFrame is a 








a. container c. formatter 

b. layout manager d. design supervisor 

Which of the following is not true of a JTextField? 795 
a. A user can type text data into it. 

b. Its data can be set in the program instead of by the user. 

c. A program can set its attributes so that a user cannot type in it. 

d. It is a type of Container. 


are popup windows that can help a user understand the purpose of 
components in an application and that appear when a user hovers the mouse 
pointer over the component. 
a. Navigation notes c. Help icons 
b. Tool tips d. Graphic suggestions 


Within an event-driven program, a component on which an event is generated is 
the 

a. performer c. source 

b. listener d. handler 


A class that will respond to button-press events must use which phrase in its 
header? 
a. import java.event c. extends JFrame 


b. extends Action d. implements ActionListener 


A JFrame contains a JButton named button1 that should execute an 
actionPerformed() method when clicked. Which statement is needed in the 
JFrame class? 

addActionListener(this); 

addActionListener(button1) ; 









button1.addActionListener(this) ; 


ao Ff SP 


this.addActionListener(button1) ; 


When you use the getSource() method with an ActionEvent object, the result 
is 


a. an Object c. a Component 
b. an ActionEvent d. aTextField 
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16. A class can implement 
one listener 
two listeners 


as many listeners as it needs 


ao Ff P 


796 any number of listeners as long as they are not conflicting listeners 





17. When you write a method that reacts to JCheckBox changes, you name the 


method 
a. itemStateChanged() c. checkBoxChanged() 
b. actionPerformed() d. any legal identifier you choose 


18. Ifa class contains two components that might each generate a specific event type, 
you can determine which component caused the event by using the 


method. 
a. addActionListenerQ c. whichOne() 
b. getSource() d. identifyOriginO 


19. To group several components such as JCheckBoxes so that a user can select only 
one at a time, you create a 


a. JCheckBoxGroup c. JButtonGroup 
b. CheckBoxGroup d. ButtonGroup 


20. Suppose that you have declared a ButtonGroup named threeOptions and added 
three JCheckBoxes named box1, box2, and box3 to it. If you code threeOptions. 
setSelected(box1);, then threeOptions.setSelected(box2) ;, and then 
threeOptions.setSelected(box3) ;, the selected box is 


a. boxl c. box3 
b. box2 d. all of the above 
Exercises 












(=) Programming Exercises 


1. Write an application that displays a JFrame containing the first few lines of your 
favorite song. Save the file as JLyrics.java. 


2. a. Write an application that instantiates a JFrame that contains a JButton. Disable 
the JButton after the user clicks it. Save the file as JFrameDisableButton.java. 


b. Modify the JFrameDisableButton program so that the JButton is not disabled 
until the user has clicked at least eight times. At that point, display a JLabel 


that indicates “That’s enough!”. Save the file as JFrameDisableButton2.java. 
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3. Create an application with a JFrame and five labels that contain the names of five 
friends. Every time the user clicks a JButton, remove one of the labels and add a 
different one. Save the file as JDisappearingFriends.java. 


4. Write an application for Lambert’s Vacation Rentals. Use separate ButtonGroups to 

allow a client to select one of three locations, the number of bedrooms, and whether 

: : : : 797 
meals are included in the rental. Assume that the locations are parkside for $600 per 
week, poolside for $750 per week, or lakeside for $825 per week. Assume that the 
rentals have one, two, or three bedrooms and that each bedroom over one adds $75 to 
the base price. Assume that if meals are added, the price is $200 more per rental. Save 
the file as JVacationRental. 








5. a. Write an application that allows a user to select one of at least 12 songs from a 
combo box. Display the purchase price, which is different for each song. Save the 
file as JTunes.java. 


b. Change the JTunes application to include an editable combo box. Allow the user 
to type the name of a song to purchase. Display an appropriate error message if 
the desired song is not available. Save the file as JTunes2.java. 


6. Design an application for a pizzeria. The user makes pizza order choices from list 
boxes, and the application displays the price. The user can choose a pizza size of small 
($7), medium ($9), large ($11), or extra large ($14), and one of any number of 
toppings. There is no additional charge for cheese, but any other topping adds $1 to 
the base price. Offer at least five different topping choices. Save the file as JPizza.java. 


7. Write an application that allows a user to select a city from a list box that contains at 
least seven options. Display the population of the city in a text field after the user 
makes a selection. Save the file as JPopulation.java. 


8. Write an application that allows the user to choose insurance options in JCheckBoxes. 
Use a ButtonGroup to allow the user to select only one of two insurance types—HMO 
(health maintenance organization) or PPO (preferred provider organization). Use 
regular (single) JCheckBoxes for dental insurance and vision insurance options; the 
user can select one option, both options, or neither option. As the user selects each 
option, display its name and price in a text field; the HMO costs $200 per month, the 
PPO costs $600 per month, the dental coverage adds $75 per month, and the vision 
care adds $20 per month. When a user deselects an item, make the text field blank. 
Save the file as JInsurance.java. 














9. a. Search the Java Web site for information on how to use a JTextArea, its 
constructors, and its setText() and append() methods. Write an application that 
allows the user to select options for a dormitory room. Use JCheckBoxes for 
options such as private room, Internet connection, cable TV connection, 
microwave, refrigerator, and so on. When the application starts, use a text area to 
display a message listing the options that are not yet selected. As the user selects 
and deselects options, add appropriate messages to the common text area 
so it accumulates a running list that reflects the user’s choices. Save the file as 
JDorm.java. 
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b. Modify the JDorm application so that instead of a running list of the user’s choices, 
the application displays only the current choices. Save the file as JDorm2.java. 


10. Create an application for Paula’s Portraits, a photography studio. Paula’s base price is 
$40 for a photo session with one person. The in-studio fee is $75 for a session with 

798 two or more subjects, and $95 for a session with a pet. A $90 fee is added to take 
photos on location instead of in the studio. The application allows users to compute 
the price of a photography session. Include a set of mutually exclusive check boxes to 
select the portrait subject and another set of mutually exclusive check boxes for the 
session location. Include labels as appropriate to explain the application’s function- 
ality. Save the file as JPhotoFrame.java. 





* Debugging Exercises 


1. Each of the following files in the Chapter14 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and fix the 
program. After you correct the errors, save each file using the same filename 
preceded with Fix. For example, DebugFourteen1.java will become 
FixDebugFourteen1.java. 


a. DebugFourteenl java c. DebugFourteen3.java 
b. DebugFourteen2.java d. DebugFourteen4.java 


“8 Game Zone 


a. Create a quiz game that displays, in turn, five questions about any topic of your 
choice. All five questions should have the same three possible multiple-choice 
answers. For example, you might ask trivia questions about U.S. states for which 
the correct response is either California, Florida, or New York. After each 
question is displayed, allow the user to choose one, two, or all three answers by 
selecting JCheckBoxes. In other words, if the user is sure of an answer, he will 
select just one box, but if he is uncertain, he might select two or three boxes. 
When the user is ready to submit the answer(s), he clicks a button. If the user’s 
answer to the question is correct and he has selected just one box, award 5 
points. If the user is correct but has selected two boxes, award 2 points. If the 
user has selected all three boxes, award 1 point. If the user has selected fewer 
than three boxes but is incorrect, the user receives 0 points. A total of 25 points 
is possible. If the user has accumulated more than 21 points at the end of the 
quiz, display the message “Fantastic!”. If the user has accumulated more than 15 
points, display the message “Very good”, and if the user has accumulated fewer 
points, display “OK”. Save the file as HedgeYourBet.java. 
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b. Modify the HedgeYourBet game so that it stores the player’s score from the last 
game in a file and displays the previous score at the start of each new game. 
(The first time you play the game, the previous score should be 0.) Save the 
game as HedgeYourBetUsingFile.java. 


2. In Chapter 5, you created a lottery game application. Create a similar game using 799 
check boxes. For this game, generate six random numbers, each between 0 and 30, 
inclusive. Allow the user to choose six check boxes to play the game. (Do not allow 
the user to choose more than six boxes.) After the player has chosen six numbers, 
display the randomly selected numbers, the player’s numbers, and the amount of 
money the user has won, as follows: 














Matching Numbers Award (S) 
- Three matches 100 
Four matches 10,000 
Five matches 50,000 
Six matches 1,000,000 
Zero, one, or two matches 0 





Save the file as JLottery2.java. 


3. a. Create a game called Last Man Standing in which the objective is to select the 
last remaining JCheckBox. The game contains 10 JCheckBoxes. The player can 
choose one, two, or three boxes, and then click a JButton to indicate the turn is 
complete. The computer then randomly selects one, two, or three JCheckBox 
objects. When the last JCheckBox is selected, display a message indicating the 
winner. Save the game as LastManStanding.java. 


b. In the current version of the Last Man Standing game, the computer might 
seem to make strategic mistakes because of its random selections. For example, 
when only two JCheckBox objects are left, the computer might randomly 
choose to check only one, allowing the player to check the last one and win. 
Modify the game to make it as smart as possible, using a random value for the 
number of the computer’s selections only when there is no superior alternative. 
Save the improved game as SmarterLastManStanding java. 












Case Problems 





1. In previous chapters, you have created a number of programs for Carly’s Catering. 
Now, create an interactive program that allows the user to enter the number of 
guests for an event into a text field; if the value entered is not numeric, set the event 
price to 0. Also allow the user to choose one entree from a group of at least 
four choices, up to two side dishes from a group of at least four choices, and one 
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dessert from a group of at least three choices. Display the cost of the event as $35 per 
person; as the user continues to select and deselect menu items, display a list of the 
current items chosen. If a user attempts to choose more than two side dishes, remove 
all the current side dish selections so that the user can start over. Save the program as 
JCarlysCatering.java. 
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2. In previous chapters, you have created a number of programs for Sammy’s Seashore 
Rentals. Now, create an interactive GUI program that allows the user to enter a rental 
time in hours into a text field; if the value entered is not numeric, set the rental price 
to 0. Also allow the user to choose one equipment type to rent from a group of seven 
choices. The rental fee is $40 per hour for a jet ski or pontoon boat; $20 per hour for a 
rowboat, canoe, or kayak; and $7 per hour for a beach chair or umbrella. Let the user 
add an equipment lesson for an extra $5. Display a message that indicates all the 
details for the rental, including the total price. Save the program as 
JSammysSeashore.java. 
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In this chapter, you will: 


Use content panes 
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Learn more about layout managers 
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Use JPanels to increase layout options 


(©) 


Create JScrol1Panes 
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Understand events and event handling more thoroughly 
Use the AWTEvent class methods 
Handle mouse events 
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Understanding the Content Pane 


The JFrame class is a top-level container Java Swing class. (The other two top-level container 

classes are JDialog and JApplet.) Every GUI component that appears on the screen must be 

part of a containment hierarchy. A containment hierarchy is a tree of components that has a 
802 top-level container as its root (that is, at its uppermost level). Every top-level container has a 
content pane that contains all the visible components in the container’s user interface. The 
content pane can directly contain components like JButtons, or it can hold other containers, 
like JPanels, that in turn contain such components. 





A top-level container can contain a menu bar. A menu bar is a horizontal strip that 
conventionally is placed at the top of a container and contains user options. The menu 

bar, if there is one, is just above (and separate from) the content pane. A glass pane resides 
above the content pane. Figure 15-1 shows the relationship between a JFrame and its root, 
content, and glass panes. 











Root pane 


Content pane 





Glass pane 








Figure 15-1 Parts of a JFrame 


the glass pane. You also can draw your own graphics on the glass pane “on top of” components on a 
JFrame or JApp et. (You will learn about drawing in the Graphics chapter, and about JApp1ets in the 
chapter Applets, Images, and Sound.) If you add a MouseListener to the glass pane, it prevents the 
mouse from triggering events on the components below the glass pane on the JFrame. 


Q The glass pane is a powerful container feature. Tool tips, which you learned about in Chapter 14, reside on 


An additional layered pane exists above the root pane, but it is not often used explicitly by Java programmers. 
For more details, see the Java Web site. 


Whenever you create a JFrame (or other top-level container), you can get a reference to its 
content pane using the getContentPane() method. In Chapter 14, you added and removed 
components from JFrames and set their layout managers without understanding you were 
using the content pane. You had this ability because Java automatically converts add(Q), 
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remove(), and setLayoutManager() statements to more complete versions. For example, the 
following three statements are equivalent within a class that descends from JFrame: 


this.getContentPane() .add(aButton) ; 
getContentPane() .add(aButton) ; 
add(aButton) ; 
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In the first statement, this refers to the JFrame class in which the statement appears, 

and getContentPane() provides a reference to the content pane. In the second statement, 
the this reference is implied. In the third statement, both the this reference and the 
getContentPane() call are implied. 


Although you do not need to worry about the content pane if you only add components to, 
remove components from, or set the layout manager of a JFrame, you must refer to the 
content pane for all other actions, such as setting the background color. 


When you write an application that adds multiple components to a content pane, it is 
more efficient to declare an object that represents the content pane than to keep calling the 
getContentPane() method. For example, consider the following code in a JFrame class 
that adds three buttons: 


getContentPane() .add(button1) ; 
getContentPane() .add(button2) ; 
getContentPane() .add(button3) ; 


You might prefer to write the following statements. The call to getContentPane() is made 
once, its reference is stored in a variable, and the reference name is used repeatedly with the 
call to the add() method: 


Container con = getContentPane() ; 
con.add(button1) ; 
con.add(button2) ; 
con.add(button3) ; 


As an example, the class in Figure 15-2 creates a JFrame like the ones you created throughout 
Chapter 14, although to keep the example simple, the default close operation was not set and 
the button was not assigned any tasks. 


import java.awt.*; 
import javax.swing.*; 
public class JFramewWithExplicitContentPane extends JFrame 


{ 


private final int SIZE = 180; 
private Container con = getContentPane() ; 
private JButton button = new JButton("Press Me"); 





Figure 15-2 The JFrameWithExplicitContentPane class (continues) 
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(continued) 


public JFrameWithExplicitContentPane() 
{ 
super("Frame") ; 
setSize(SIZE, SIZE); 
con.setLayout(new FlowLayout()); 
con.add (button) ; 
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public static void main(String[] args) 
{ 
JFramewithExplicitContentPane frame = 
new JFrameWithExplicitContentPane() ; 
frame.setVisible(true) ; 





Figure 15-2 The JFramewithExp1licitContentPane class 


In Figure 15-2, the getContentPane() method assigns a reference to a Container named 
con, and the Container reference is used later with the setLayout() and add() methods. 
Figure 15-3 shows the result. The frame constructed from the class in Figure 15-2 is identical 
to the one that would be constructed if the shaded parts were omitted. 





Figure 15-3 Output of the JFrameWi thExplicitContentPane application 


When you want to use methods other than add(), remove(), or setLayout(), you must use a 
content pane. In the next sections you will learn about methods such as setBackground(), 
which is used to change a JFrame’s background color, and setLayout(), which is used to 
change a JFrame’s layout manager. If you use these methods with a JFrame instead of its 
content pane, the user will not see the results. 
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Understanding the Content Pane 


1. Every Java component has a content pane that contains all the visible parts a 805 
user sees. 








2. Whenever you create a JFrame, you can get a reference to its content pane 
using the getContentPane() method. 


3. When you change the background color or layout of a JFrame, you should 
change the content pane and not the JFrame directly. 
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Using Color 


The Color class defines colors for you to use in your applications. The Color class can be 
used with the setBackground() and setForeground() methods of the Component class to 
make your applications more attractive and interesting. When you use the Color class, you 
include the statement import java.awt.Color; at the top of your class file. 


package, but it does not import java. awt.Color, java.awt.Font, or any other packages within 
awt. If you plan to use the classes from java. awt and from java.awt.Color, you must use both 
import statements. 


Q The statement import java.awt.* uses the wildcard to import all of the types in the java. awt 


The Color class defines named constants that represent 13 colors, as shown in Table 15-1. 
Java constants are usually written in all uppercase letters, as you learned in Chapter 2. 
However, Java's creators declared two constants for every color in the Color class—an 
uppercase version, such as BLUE, and a lowercase version, such as blue. Earlier versions of 
Java contained only the lowercase Color constants. (The uppercase Color constants use an 
underscore in DARK_GRAY and LIGHT_GRAY; the lowercase versions are a single word: darkgray 
and lightgray.) 
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BLACK GREEN RED 

BLUE LIGHT_GRAY WHITE 

CYAN MAGENTA YELLOW 
806 DARK_GRAY ORANGE 

GRAY PINK 


Wel) ENe Sh Color class constants 


You can also create your own Color object with the following statement: 
Color someColor = new Color(r, g, b); 


In this statement, r, g, and b are numbers representing the intensities of red, green, and blue 
you want in your color. The numbers can range from 0 to 255. For example, the color black is 
created using r, g, and b values 0, 0, 0, and white is created by 255, 255, 255. The following 
statement produces a dark purple color that has red and blue components, but no green. 


Color darkPurple = new Color(100, 0, 100); 


You can create more than 16 million custom colors using this approach. Some computers 
cannot display each of the 16 million possible colors; each computer displays the closest 
color it can to the requested color. 


You can discover the red, green, or blue components of any existing color with the 
methods getRed(), getGreen(), and getBlue(). Each of these methods returns an integer. 
For example, you can discover the amount of red in MAGENTA by displaying the value of 
Color.MAGENTA.getRedQ);. 


Figure 15-4 shows a short application that sets the background color of a JFrame’s content 
pane and sets both the foreground and background colors of a JButton. Figure 15-5 shows 
the output. 


import java.awt.*; 

import javax.swing.*; 

import java.awt.Color; 

public class JFramewithColor extends JFrame 


{ 


private final int SIZE = 180; 
private Container con = getContentPane() ; 
private JButton button = 

new JButtonC"Press Me"); 





Figure 15-4 The JFrameWithColor class (continues) 
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(continued) 


public JFrameWithColor(Q) 
{ 


super("Frame") ; 
setSize(SIZE, SIZE); 
con.setLayout(new FlowLayout()); 807 
con.add(button) ; 
con.setBackground(Color. YELLOW) ; 
button.setBackground(Color.RED) ; 
button.setForeground(Color.WHITE) ; 








} 
public static void main(String[] args) 
{ 
JFramewithColor frame = 
new JFrameWithColorQ; 
frame.setVisible(true); 








Figure 15-5 Execution of the JFrameWithColor application 


the figures. However, when you work through the “You Do It” exercises later in this chapter, you can observe 


Because this book is printed in only two colors, you can’t see the full effect of setting applications’ colors in 
Y the effect of color changes on your own monitor. 
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Using Color 


1. The Color class can be used with the setBackground() and setForeground(Q) 
methods of the Component class to make your applications more attractive and 
interesting. 


The Color class defines named constants that represent 256 colors. 


You can create your own Color object using values that represent the 
intensities of red, green, and blue you want in your color. 
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Learning More About Layout Managers 


A layout manager is an object that controls the size and position (that is, the layout) of 
components inside a Container object. The layout manager that you assign to a Container 
determines how its components are sized and positioned. Layout managers are interface 
classes that are part of the JDK; they align your components so the components neither 
crowd each other nor overlap. For example, you have already learned that the FlowLayout 
layout manager positions components in rows from left to right across their container. 
Other layout managers arrange components in equally spaced columns and rows or center 
components within their container. Each component you place within a Container can also 
be a Container itself, so you can assign layout managers within layout managers. The Java 
platform supplies layout managers that range from the very simple (FlowLayout and 
GridLayout) to the special purpose (BorderLayout and CardLayout) to the very flexible 
(GridBagLayout and BoxLayout). Table 15-2 lists each layout manager and situations in 
which each is commonly used. 
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Layout Manager When to Use 





BorderLayout Use when you add components to a maximum of five sections arranged 
in north, south, east, west, and center positions. 


FlowLayout Use when you need to add components from left to right; FlowLayout 
automatically moves to the next row when needed, and each component 
takes its preferred size. 
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GridLayout Use when you need to add components into a grid of rows and columns; each 
component is the same size. 

CardLayout Use when you need to add components that are displayed one at a time. 

BoxLayout Use when you need to add components into a single row or a single column. 

GridBagLayout Use when you need to set size, placement, and alignment constraints for 


every component that you add. 


Wel) (key = Java layout managers 


Using BorderLayout 


The BorderLayout manager is the default manager class for all content panes. You can use 
the BorderLayout class with any container that has five or fewer components. (However, 
any of the components could be a container that holds even more components.) When you 
use the BorderLayout manager, the components fill the screen in five regions: north, south, 
east, west, and center. Figure 15-6 shows a JFrame that uses BorderLayout; each of the five 
regions in the content pane contains a JButton object with descriptive text. 


North Button 


West Button Center Button East Button 


South Button 


Figure 15-6 Output of the JDemoBorderLayout application 








When you add a component to a container that uses BorderLayout, the add() method uses 
two arguments: the component and the region to which the component is added. The 
BorderLayout class provides five named constants for the regions—BorderLayout . NORTH, 
SOUTH, .EAST, .WEST, and .CENTER—or you can use the Strings those constants represent: 
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“North”, “South”, “East”, “West”, or “Center”. Figure 15-7 shows the class that creates the 
output in Figure 15-6. 
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import jav 


a.awt.*; 


import javax.swing.*; 


public class JDemoBorderLayout extends JFrame 


{ 
private 
private 
private 
private 
private 
private 
public 
{ 

con. 
con 
con 
con 
con 
con 


} 


JButton 
JButton 
JButton 
JButton 
JButton 


Container con 


nb = 


sb 
eb 


wb = 


cb 


new 
new 
new 
new 
new 


JButtonC"North Button") ; 
JButtonC"South Button"); 
JButton(C"East Button"); 
JButtonC("West Button"); 
JButton("Center Button"); 


= getContentPane(); 
JDemoBorderLayout () 


setLayout(new BorderLayout()); 
BorderLayout.NORTH) ; 
BorderLayout. SOUTH) ; 
BorderLayout . EAST) ; 
BorderLayout.WEST) ; 
BorderLayout.CENTER) ; 


.add(nb, 
.add(sb, 
.add(eb, 
.add(wb, 
.add(cb, 
setSize(400, 150); 


public static void main(String[] args) 


{ 


JDemoBorderLayout frame = new JDemoBorderLayout() ; 
frame.setVisible(true); 





Figure 15-7 The JDemoBorderLayout class 


LINE_END, and CENTER instead of NORTH, SOUTH, EAST, WEST, and CENTER. Rather than using 


Q When using BorderLayout, you can use the constants PAGE_START, PAGE_END, LINE_START, 


geographical references, these constants correspond to positions as you might picture them on a printed 
page. Also, if you add the following import statement at the top of your file, you can simply refer to CENTER 
instead of BorderLayout.CENTER 


import static java.awt.BorderLayout.*; 


When you place exactly five components in a container and use BorderLayout, each 
component fills one entire region, as illustrated in Figure 15-6. When the application runs, 
Java determines the exact size of each component based on the component’s contents. When 
you resize a Container that uses BorderLayout, the regions also change in size. If you drag 
the Container’s border to make it wider, the north, south, and center regions become wider, 
but the east and west regions do not change. If you increase the Container’s height, the east, 
west, and center regions become taller, but the north and south regions do not change. 
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In Figure 15-7, an anonymous BorderLayout object is created when the constructor is called 
from within the setLayout() method. Instead, you could declare a named BorderLayout 
object and use its identifier in the setLayout() call. However, it’s not necessary to use either 
technique to specify BorderLayout because it is the default layout manager for all content 
panes; that’s why, in many examples in the last chapter, you had to specify FlowLayout to 
acquire the easier-to-use manager. 811 








When you use BorderLayout, you are not required to add components into each of the five 
regions. If you add fewer components, any empty component regions disappear, and the 
remaining components expand to fill the available space. If any or all of the north, south, east, 
or west areas are left out, the center area spreads into the missing area or areas. However, if 
the center area is left out, the north, south, east, or west areas do not change. A common 
mistake when using BorderLayout is to add a Component to a content pane or frame without 
naming a region. This can result in some of the components not being visible. 


Using FlowLayout 


Recall from the last chapter, Introduction to Swing Components, that you can use the 
FlowLayout manager class to arrange components in rows across the width of a Container. 
With FlowLayout, each Component that you add is placed to the right of previously added 
components in a row; or, if the current row is filled, the Component is placed to start a 

new row. 


When you use BorderLayout, the Components you add fill their regions—that is, each 
Component expands or contracts based on its region’s size. However, when you use 
FlowLayout, each Component retains its default size, or preferred size. For example, a 
JButton’s preferred size is the size that is large enough to hold the JButton’s text. When you 
use BorderLayout and then resize the window, the components change size accordingly 
because their regions change. When you use FlowLayout and then resize the window, each 
component retains its size, but it might become partially obscured or change position. 


The FlowLayout class contains three constants you can use to align Components with a 
Container: 


e FlowLayout.LEFT 
e FlowLayout.CENTER 
e FlowLayout.RIGHT 


If you do not specify alignment, Components are center-aligned in a FlowLayout Container 
by default. Figure 15-8 shows an application that uses the FlowLayout.LEFT and 
FlowLayout.RIGHT constants to reposition JButtons. In this example, a FlowLayout object 
named layout is used to set the layout of the content pane. When the user clicks a button, 
the shaded code in the actionPerformed() method changes the alignment to left or right 
using the FlowLayout class setAlignment() method. Figure 15-9 shows the application when 
it starts, how the JButton Components are repositioned after the user clicks the “L” button, 
and how the Components are repositioned after the user clicks the “R” button. 
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import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
812 public class JDemoFlowLayout extends JFrame implements ActionListener 


{ 





private JButton 1b = new JButton("L Button"); 
private JButton rb = new JButton("R Button"); 
private Container con = getContentPane() ; 
private FlowLayout layout = new FlowLayout(); 
public JDemoFlowLayout() 
{ 
con.setLayout (layout) ; 
con.add(1b); 
con.add(rb) ; 
1b.addActionListener(this) ; 
rb.addActionListener(this) ; 
setSize(500, 100); 
} 
public void actionPerformed(ActionEvent event) 
{ 
Object source = event.getSource(); 
ifCsource == 1b) 
layout .setAlignment(FlowLayout.LEFT) ; 
else 
layout. setAlignment(FlowLayout.RIGHT) ; 
con.invalidate(); 
con.validateQ; 
} 
public static void main(String[] args) 


{ 


JDemoFlowLayout frame = new JDemoFlowLayout(); 
frame.setVisible(true) ; 





Figure 15-8 The JDemoFlowLayout application 


The invalidate() call marks the container (and any of its parents) as needing to be laid out. The 


The last statements in the JDemoFlowLayout class call invalidate() and validate(). 
GY validate() call causes the components to be rearranged based on the newly assigned layout. 
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Figure 15-9 The JDemoFlowLayout application as it first appears on the screen, after the user 
chooses the “L” Button, and after the user chooses the “R” Button 


Using GridLayout 


If you want to arrange components into equal rows and columns, you can use the GridLayout 
manager class. When you create a GridLayout object, you indicate the numbers of rows and 
columns you want, and then the container surface is divided into a grid, much like the screen 
you see when using a spreadsheet program. For example, the following statement establishes 
an anonymous GridLayout with four horizontal rows and five vertical columns in a 
Container named con: 


con.setLayout(new GridLayout(4, 5)); 


Specifying rows and then columns when you use GridLayout might seem natural to you, 
because this is the approach you take when defining two-dimensional arrays. 


As you add new Components to a GridLayout, they are positioned in sequence from left to 
right across each row. Unfortunately, you can’t skip a position or specify an exact position for 
a component. (However, you can add a blank label to a grid position to give the illusion of 
skipping a position.) You also can specify a vertical and horizontal gap measured in pixels, 
using two additional arguments. For example, Figure 15-10 shows a JDemoGridLayout 
program that uses the shaded statement to establish a GridLayout with three horizontal rows 
and two vertical columns, and horizontal and vertical gaps of five pixels each. Five JButton 
Components are added to the JFrame’s automatically retrieved content pane. 
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import javax.swing.*; 

import java.awt.*; 

public class JDemoGridLayout extends JFrame 
{ 

814 private JButton bl = new JButtonC"Button 
private JButton b2 = new JButton("Button 
private JButton b3 = new JButton("Button 
private JButton b4 = new JButton("Button 
private JButton b5 = new JButton("Button 
private GridLayout layout = new GridLayout( 
private Container con = getContentPane() ; 
public JDemoGridLayout() 

{ 





1") 
2") 
3") 
4") 
5") 
tG 


con.setLayout (layout) ; 
con.add(b1); 
con.add(b2) ; 
con.add(b3); 
con.add(b4) ; 
con.add(b5); 
setSize(200, 200); 
} 
public static void main(String[] args) 
{ 
JDemoGridLayout frame = new JDemoGridLayout() ; 
frame.setVisible(true) ; 





Figure 15-10 The JDemoGridLayout class 


Figure 15-11 shows the output of the JDemoGridLayout application. The Components are 
placed into the pane across the three rows. Because there are six positions but only five 
Components, one spot remains unused. 
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Figure 15-11 Output of the JDemoGridLayout program 


With GridLayout, you can specify the number of rows and use 0 for the number of 
columns to let the layout manager determine the number of columns, or you can use 0 for 
the number of rows, specify the number of columns, and let the layout manager calculate 
the number of rows. 


When trying to decide whether to use GridLayout or FlowLayout, remember the following: 


e Use GridLayout when you want components in fixed rows and columns and you want the 
components’ size to fill the available space. 


e Use FlowLayout if you want Java to determine the rows and columns, do not want a rigid 
row and column layout, and want components to retain their “natural” size so their 
contents are fully visible. 


Using CardLayout 


The CardLayout manager generates a stack of containers or components, one on top of 
another, much like a blackjack dealer reveals playing cards one at a time from the top of 

a deck. Each component in the group is referred to as a card, and each card can be any 
component type—for example, a JButton, JLabel, or JPanel. You use a CardLayout when 
you want multiple components to share the same display space. 


A card layout is created from the CardLayout class using one of two constructors: 
e CardLayout( creates a card layout without a horizontal or vertical gap. 


e CardLayoutCint hgap, int vgap) creates a card layout with the specified horizontal and 
vertical gaps. The horizontal gaps are placed at the left and right edges. The vertical gaps 
are placed at the top and bottom edges. 
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For example, Figure 15-12 shows a JDemoCardLayout class that uses a CardLayout manager 
to create a stack of JButtons that contain the labels “Ace of Hearts”, “Three of Spades”, 
and “Queen of Clubs”. In the class constructor, you need a slightly different version of the 
add() method to add a component to a content pane whose layout manager is CardLayout. 
The format of the method is: 

816 





add(aString, aContainer) ; 


In this statement, aString represents a name you want to use to identify the Component 
card that is added. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
public class JDemoCardLayout extends JFrame 
implements ActionListener 
{ 
private CardLayout cards = new CardLayout(); 
private JButton bl = new JButton("Ace of Hearts"); 
private JButton b2 new JButton("Three of Spades"); 
private JButton b3 = new JButton("Queen of Clubs"); 
private Container con = getContentPane() ; 
public JDemoCardLayout () 
{ 
con.setLayout (cards) ; 
con.add("ace", b1); 
b1.addActionListener(this) ; 
con.addC("three", b2); 
b2.addActionListener(this) ; 
con.add("queen", b3); 
b3.addActionListener(this) ; 
setSize(200, 100); 
} 
public void actionPerformed(ActionEvent e) 


{ 
} 


public static void main(String[] args) 


3 


cards.next(getContentPane()) ; 


JDemoCardLayout frame = new JDemoCardLayout(); 
frame.setVisible(true) ; 





Figure 15-12 The JDemoCardLayout class 
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In a program that has a CardLayout manager, a change of cards is usually triggered by a user’s 
action. For example, in the JDemoCardLayout program, each JButton can trigger the 
actionPerformed() method. Within this method, the statement next (getContentPane()) 
flips to the next card of the container. (The order of the cards depends on the order in 
which you add them to the container.) You also can use previous(getContentPane());, 
first(getContentPane());, and last(getContentPane()); to flip to the previous, first, and 817 
last card, respectively. You can go to a specific card by using the String name assigned in 

the add@ method call. For example, in the application in Figure 15-12, the following 

statement would display “Three of Spades” because "three" is used as the first argument 

when the b2 object is added to the content pane in the JDemoCardLayout constructor: 








cards.show(getContentPane(), "“three"); 


Figure 15-13 shows the output of the JDemoCardLayout program when it first appears on the 
screen, after the user clicks the button once, and after the user clicks the button a second 
time. Because each JButton is a card, each JButton consumes the entire viewing area in the 
container that uses the CardLayout manager. If the user continued to click the card buttons 
in Figure 15-13, the cards would continue to cycle in order. 





Ace of Hearts 





Figure 15-13 Output of JDemoCardLayout when it first appears on the screen, after the user 
clicks once, and after the user clicks twice 


are in place for the user to select the various components. You can find out more about the class 


The JTabbedPane class operates like a container with a CardLayout, but folder-type tabs 
Y at www.oracle.com/technetwork/java/index.html. 


Using Advanced Layout Managers 


Just as professional Java programmers are constantly creating new Components, they also 
create new layout managers. You are certain to encounter new and interesting layout 
managers during your programming career; you might even create your own. 


For example, when GridLayout is not sophisticated enough for your purposes, you can use 
GridBagLayout. The GridBagLayout manager allows you to add Components to precise 
locations within the grid, as well as to indicate that specific Components should span multiple 
rows or columns within the grid. For example, if you want to create a JPanel with six 
JButtons, in which two of the JButtons are twice as wide as the others, you can use 
GridBagLayout. This class is difficult to use because you must set the position and size for 
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each component, and more than 20 methods are associated with the class. Visit the Java 
Web site for details on how to use this class. 


Another layout manager option is the BoxLayout manager, which allows multiple 
components to be laid out either vertically or horizontally. The components do not wrap, so a 
vertical arrangement of components, for example, stays vertically arranged when the frame 


ai is resized. The Java Web site can provide you with details. 





ee 
eu Watch the video Layout Managers. 





Learning More About Layout Managers 


1. The FlowLayout manager is the default manager class for all content panes. 
2. The BorderLayout manager can directly hold only up to five components. 


3. The GridLayout manager arranges components in rows and columns. 


“Saued jUa}U09 ||e 40} ssejo 
JaSeUeW YNeJap au} S| JaBeULL AnoAequapog BY] “[# SI JUaWA}e}s aSje} BU] 


aN You Do It 


Using BorderLayout 


Using layout managers in the containers in your applications allows flexibility in 
arranging the components that users see on the screen. In this section, you create 
a JFrame that uses a BorderLayout and place components in each region. In the 
following sections, you will observe how the same components appear when other 
layout managers are used. 


1. Open a new file in your text editor, and then type the following first few lines 
of a program that demonstrates BorderLayout with five objects: 


import javax.swing.*; 
import java.awt.*; 
public class JBorderLayout extends JFrame 


: (continues) 
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(continued) 


2. Instantiate five JButton objects, each with a label that is the name of one of the 
regions used by BorderLayout: 


new JButtonC"North"); abe 


new JButtonC("South") ; 
new JButton("East"); 
new JButton("West"); 
new JButton("Center") ; 


private JButton nb 
private JButton sb 
private JButton eb 
private JButton wb 
private JButton cb 


3. Write the constructor that sets the JFrame’s layout manager and adds each of 
the five JButtons to the appropriate region. Also set the default close operation 
for the JFrame. 








public JBorderLayout () 
{ 

setLayout(new BorderLayout()) ; 

add(nb, BorderLayout .NORTH) ; 

add(sb, BorderLayout .SOUTH) ; 

add(eb, BorderLayout .EAST) ; 

add(wb, BorderLayout .WEST) ; 

add(cb, BorderLayout.CENTER) ; 

setDefaul tCl oseOperation(JFrame.EXIT_ON_CLOSE) ; 
} 


4. Add amainQ method that instantiates a JBorderLayout object and sets its size 
and visibility, and include a closing curly brace for the class: 


public static void main(String[] args) 
{ 
JBorderLayout jbl = new JBorderLayout(); 
jbl.setSize(250, 250); 
jbl .setVisible(true) ; 
} 
} 


5. Save the file as JBorderLayout.java, and then compile and execute it. 
The output looks like Figure 15-14. Each JButton entirely fills its region. 
(If you click the JButtons, they appear to be pressed, but because you have 
not implemented ActionListener, no other action is taken.) 
(continues) 
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(continued) 
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Figure 15-14 Output of the JBorderLayout program 


So you can observe the effects of changing the size of the viewing area, 
use your mouse to drag the right border of the JFrame to increase the width 
to approximately that shown in Figure 15-15. Notice that the center region 


expands, while the east and west regions retain their original size. 


Figure 15-15 Output of the JBorderLayout program after the user drags the right 
border to increase the width 


(continues) 
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(continued) 


7. Experiment with resizing both the width and height of the JFrame. Close the 
JFrame when you finish. 
821 








Using Fewer than Five Components with the BorderLayout Manager 


When you use JBorderLayout, you are not required to place components in every 
region. For example, you might use only four components, leaving the north region 
empty. Next, you remove one of the objects from the JBorderLayout JFrame to 
observe the effect. 


1. Open the JBorderLayout.java file in your text editor. Immediately save it as 
JBorderLayoutNoNorth.java. 


2. Change the class name to JBorderLayoutNoNorth. Also change the constructor 
name and the two instances of the class name in the main@ method. 


3. Remove the declaration of the “North” button, and within the constructor, 
remove the statement that adds the “North” button to the JFrame. 


4. Save the file, compile it, and then run the program. The output appears as 
shown in Figure 15-16. The center region occupies the space formerly held 
by the north region. 











Figure 15-16 Output of the JBorderLayoutNoNorth program 


5. Experiment with removing some of the other components from the 
JBorderLayoutNoNorth program. 


(continues) 
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(continued) 
Using FlowLayout 


Next, you modify the JBorderLayout program to demonstrate how the same 


822 
components appear when using FlowLayout. 





1. Open the JBorderLayout.java file in your text editor, and immediately save it as 
JFlowLayoutRight.java. 


2. Change the class name from JBorderLayout to JFlowLayoutRight. Also change 
the constructor name and the references to the name in the main@ method. 


3. Within the constructor, change the setLayout() statement to use FlowLayout 
and right alignment: 


setLayout (new FlowLayout (Fl owLayout .RIGHT)) ; 


4. Alter each of the five addQ) statements so that just the button name appears 
within the parentheses and the region is omitted. For example, add(nb, 
BorderLayout.NORTH) ; becomes the following: 


add(nb) ; 


5. Save the file, and then compile and execute it. Your output should look like 
Figure 15-17. The components have their “natural” size (or preferred size)—the 
minimum size the buttons need to display their labels. The buttons flow across the 
JFrame surface in a row until no more can fit; in Figure 15-17 the last two buttons 
added cannot fit in the first row, so they appear in the second row, rightaligned. 


















































Figure 15-17 Output of the JFlowLayoutRight program 


(continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce: earning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





Learning More About Layout Managers) 


(continued) 


6. Experiment with widening and narrowing the JFrame, and observe how the 


components realign. Then close the JFrame. ss 








Using GridLayout 
Next, you modify a JFrame to demonstrate GridLayout. 


1. Open the JFlowLayoutRight.java file in your text editor, and save the file as 
JGridLayout.java. 


2. Change the class name from JFlowLayoutRight to JGridLayout. Change the 
constructor name and the two references to the class in the main@) method. 


3. Within the constructor, change the setLayout() statement to establish a 
GridLayout with two rows, three columns, a horizontal space of two pixels, and 
a vertical space of four pixels: 


setLayout (new GridLayout(2, 3, 2, 4)); 


4. Save the file, and then compile and execute it. The components are arranged 
in two rows and three columns from left to right across each row, in the order 
they were added to their container. Because there are only five components, 
one grid position still is available. See Figure 15-18. 


























Figure 15-18 Output of the JGridLayout program 


5. Close the program. 


(continues) 
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(continued) 
Using CardLayout 


Next, you create a CardLayout with five cards, each holding one of the JButtons used 
824 in the previous examples. 





1. Open the JGridLayout.java file in your text editor, and save the file as 
JCardLayout.java. 


2. Change the class name from JGridLayout to JCardLayout. Also change 
the constructor name and the two references in the main@ method. 


3. Within the constructor, change the setLayout() statement to establish a 
CardLayout: 


setLayout(new CardLayout()); 


4. Change the five add() statements that add the buttons to the content pane 
so that each includes a String that names the added component, as follows: 


addC"north", nb); 
addC"south", sb); 
addC"east", eb); 
addC"west", wb); 
addC"center", cb); 


5. Save the file, and then compile and execute it. The output looks like 
Figure 15-19. You see only the “North” Button because, as the first 
one added, it is the top card. You can click the button, but no actions take 
place because you have not implemented ActionListener. 











Figure 15-19 Output of the JCardLayout program 
(continues) 
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(continued) 
6. Close the program. 
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Viewing All the Cards in CardLayout 


Next, you modify the JcardLayout program so that its buttons can initiate events that 
allow you to view all five JButtons you add to the content pane. 


1. Open the JCardLayout.java file in your text editor, and save the file as 
JCardLayout2.java. 


2. Change the class name, constructor name, and two main) method references 
from JCardLayout to JCardLayout2. 


3. At the top of the file, add the import statement that adds the classes and 
methods that allow the class to respond to events: 


import java.awt.event.*; 


4. At the end of the class header, insert the following phrase so the JFrame can 
respond to button clicks: 


implements ActionListener 


5. Instead of an anonymous layout manager, you need to create a CardLayout 
manager with an identifier that you can use with the next method when the 
user clicks a button. Immediately after the five JButton declaration statements, 
insert the following statement: 


CardLayout cardLayout = new CardLayout() ; 


6. Within the constructor, change the setLayout© statement so it uses the named 
layout manager: 


setLayout(cardLayout) ; 


7. Atthe end of the constructor, add five statements that allow each of the buttons 
to initiate an ActionEvent: 


nb.addActionListener(this) ; 
sb.addActionListener (this) ; 
eb.addActionListener(this) ; 
wb.addActionListener(this) ; 
cb.addActionListener(this) ; 


(continues) 
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(continued) 


8. After the constructor’s closing curly brace, add an actionPerformed() method 
that responds to user clicks. The method uses the next) method to display the 
826 next card (next button) in the collection. 





public void actionPerformed(ActionEvent e) 


{ 


} 


9. Save, compile, and run the program. The output looks the same as in 
Figure 15-19: you see only the “North” JButton. However, when you click it, 
the button changes to “South”, “East”, “West”, and “Center” in succession. 
Close the JFrame when you finish. 


cardLayout .next(getContentPane()) ; 


Using the JPanel Class 


Using the BorderLayout, FlowLayout, GridLayout, and CardLayout managers would provide 
a limited number of screen arrangements if you could place only one Component in a section 
of the layout. Fortunately, you can greatly increase the number of possible component 
arrangements by using the JPanel class. A JPane1 is a plain, borderless surface that can hold 
lightweight UI components. Figure 15-20 shows the inheritance hierarchy of the JPane] class. 
You can see that every JPanel is a Container; you use a JPanel to hold other UI components, 
such as JButtons, JCheckBoxes, or even other JPanels. By using JPanels within JPanels, you 
can create an infinite variety of screen layouts. The default layout manager for every JPanel] is 
FlowLayout. 


java.lang.Object 
+-- java.awt.Component 
!__java.awt.Container 


!_-javax.swing.JComponent 
}.-javax.swing. JPanel 





Figure 15-20 The inheritance hierarchy of the JPanel class 


To add a component to a JPanel, you call the container’s addQ) method, using the 
component as the argument. For example, Figure 15-21 shows the code that creates a 
JFrameWithPanels class that extends JFrame. A JButton is added to a JPanel named pane11, 
and two more JButtons are added to another JPanel named pane12. Then panel1 and 
panel2 are added to the JFrame’s content pane. 
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import javax.swing.*; 

import java.awt.*; 

import java.awt.Color; 

public class JFrameWithPanels extends JFrame 

{ 827 
private final int WIDTH = 250; 
private final int HEIGHT = 120; 
private JButton button1l = new JButton("One") ; 
private JButton button2 = new JButton("Two") ; 
private JButton button3 = new JButton("Three") ; 
public JFrameWithPanels() 
{ 








super("JFrame with Panels"); 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
JPanel panell = new JPanel(); 
JPanel panel2 = new JPanel(); 
Container con = getContentPane() ; 
con.setLayout(new FlowLayout()); 
con.add(panel11); 
con.add(panel2) ; 
panel1.add(button1) ; 
panel1.setBackground(Color.BLUE) ; 
panel2.add(button2) ; 
panel2.add(button3) ; 
panel2.setBackground(Color.BLUE) ; 
setSize(WIDTH, HEIGHT); 

} 

public static void main(String[] args) 


{ 


JFramewithPanels frame = new JFrameWithPanels(); 
frame.setVisible(true) ; 





Figure 15-21 The JFrameWithPanels class 


Figure 15-22 shows the output of the JFramewithPanels program. Two JPanels have been 
added to the JFrame. Because this application uses the setBackground() method to make 
each JPanel’s background blue, you can see where one panel ends and the other begins. The 
first JPanel contains a single JButton, and the second one contains two JButtons. 
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Figure 15-22 Output of the JFramewWithPanels application 


When you create a JPanel object, you can use one of four constructors. The different 
constructors allow you to use default values or to specify a layout manager and whether 
the JPanel is double buffered. If you indicate double buffering, which is the default buffering 
strategy, you specify that additional memory space will be used to draw the JPanel offscreen 
when it is updated. With double buffering, a redrawn JPanel is displayed only when it is 
complete; this provides the viewer with updated screens that do not flicker while being 
redrawn. The four constructors are as follows: 


e JPanelQ creates a JPanel with double buffering and a flow layout. 


e JPanel(LayoutManager layout) creates a JPanel with the specified layout manager and 
double buffering. 


e JPanel(Boolean isDoubleBuffered) creates a JPanel with a flow layout and the 
specified double-buffering strategy. 


e JPanel(LayoutManager layout, Boolean isDoubleBuffered) creates a JPanel with the 
specified layout manager and the specified buffering strategy. 


offscreen image is called the back buffer. The act of copying the contents from one surface to another is 
frequently referred to as a block line transfer, or blitting, because of the acronym bit, pronounced biit. 
Double buffering prevents “tearing,” the visual effect that occurs when you see parts of different images 
because the redrawing rate is not fast enough. As with most beneficial features, double buffering has a cost: 
additional memory requirements. 


Q When you employ double buffering, the visible screen surface is called the primary surface, and the 


As with many aspects of Java, there are multiple ways to achieve the same results. For 
example, each of the following techniques creates a JPanel that uses a BorderLayout 
manager: 


e You can create a named layout and use it as an argument in a JPanel constructor: 


BorderLayout border = new BorderLayout(); 
JPanel myPanel = new JPanel (border) ; 


e You can use an anonymous layout manager in the JPanel constructor: 


JPanel myPanel = new JPanel(new BorderLayout()); 
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e You can create a JPanel and then set its layout manager using the setLayout() method: 


JPanel myPanel = new JPanel(); 
myPanel.setLayout(new BorderLayout()); 


When a JPanel will have a layout other than FlowLayout, specifying the layout manager 

when you create the JPanel is preferable for performance reasons. If you create the JPanel 829 
first and change its layout later, you automatically create an unnecessary FlowLayout object 
for the original instantiation. 








You add components to a JPanel with the addQ) method. Figure 15-23 shows a 
JDemoManyPanels program in which the JFrame contains four JPanels and 12 JButtons 
that each display a single spelled-out number so you can better understand their positions. 
The automatically supplied content pane for the JFrame is assigned a BorderLayout, and 
each JPanel is assigned either a GridLayout or FlowLayout and placed in one of the regions 
(leaving the north region empty). One or more JButtons are then placed on each JPanel. 
Figure 15-24 shows the output as the user adjusts the borders of the JFrame to change its 
size. Using the code as a guide, be certain you understand why each JButton appears as 

it does in the JFrame. 


import javax.swing.*; 

import java.awt.*; 

public class JDemoManyPanels extends JFrame 

{ 

// Twelve buttons 
private JButton button01 JButtonC"One") ; 
private JButton button02 JButtonC"Two") ; 
private JButton button03 = JButtonC"Three") ; 
private JButton button04 = JButton("Four") ; 
private JButton button05 = JButtonC("Five"); 
private JButton button06 = JButton("Six"); 
private JButton button07 = JButtonC("Seven") ; 
private JButton button08 = JButtonC"Eight") ; 
private JButton button09 = JButtonC"Nine"); 
private JButton button10 JButtonC"Ten"); 
private JButton buttonl1l1 = JButtonC"Eleven"); 
private JButton buttonl12 = JButton("Twelve"); 


// Four panels 
private JPanel panel01 = JPanel(new GridLayout(2, 0)); 
private JPanel panel02 JPanel (new FlowLayout()); 
private JPanel panel03 JPanel (new FlowLayout()); 
private JPanel panel04 = JPanel(new GridLayout(2, 0)); 





Figure 15-23 The JDemoManyPane!ls class (continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 15 Advanced GUI Topics 


(continued) 


public JDemoManyPanels() 
{ 
setLayout(new BorderLayout()); 
830 add(panel01, BorderLayout.WEST) ; 
add(panel02, BorderLayout.CENTER) ; 
add(panel03, BorderLayout . SOUTH) ; 
add(panel04, BorderLayout.EAST) ; 





panel01.add(button01) ; 
panel01.add(button02) ; 
panel01.add(button03) ; 


panel02.add(button04) ; 
panel02.add(button05) ; 
panel02.add(button06) ; 


panel03.add(button07) ; 


panel04.add(button08) ; 
panel04.add(button09) ; 
panel04.add(button10) ; 
panel04.add(button11) ; 
panel04.add(button12) ; 


setSize(400, 250); 
} 


public static void main(String[] args) 


{ 


JDemoManyPanels frame = new JDemoManyPanels(); 
frame.setVisible(true) ; 





Figure 15-23 The JDemoManyPanels class 


to create arrays of the components instead of so many individually named ones. This example does not use 


If you were creating a program with as many buttons and panels as the one in Figure 15-23, you might prefer 
Y an array so you can more easily see how each component is placed. 
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Figure 15-24 Output of the JDemoManyPanels program: three views as the user adjusts the 
JFrame borders 
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Swing containers other than JPanel and content panes generally provide Application Program Interface 
GY (API) methods that you should use instead of the add() method. See the Java Web site for details. 


832 GridLayout provides you with rows and columns that are similar to a two-dimensional array. 
Therefore, it particularly lends itself to displaying arrays of objects. For example, Figure 15-25 
contains a Checkerboard class that displays a pattern of eight rows and columns in alternating 
colors. The JPanel placed in the content pane has a GridLayout of eight by eight. Sixty-four 
JPanels are declared, and in a loop, one by one, they are instantiated and assigned to a section 
of the grid (see shaded statements). After each set of eight JPanels is assigned to the grid 
(when x is evenly divisible by 8), the first and second color values are reversed, so that the first 
row starts with a blue square, the second row starts with a white square, and so on. Within 
each row, all the even-positioned squares are filled with one color, and the odd-positioned 
squares are filled with the other. Figure 15-26 shows the output. 





import java.awt.*; 
import javax.swing.*; 
import java.awt.Color; 
public class Checkerboard extends JFrame 
{ 
private final int ROWS = 
private final int COLS 
private final int GAP = 
private final int NUM = ROWS * COLS; 
private int x; 
private JPanel pane = new JPanel 
Cnew GridLayoutCROWS, COLS, GAP, GAP)); 
private JPanel[] panel = new JPanel [NUM]; 
private Color colorl = Color.WHITE; 
private Color color2 = Color.BLUE; 
private Color tempColor; 
public Checkerboard() 
{ 
super ("Checkerboard") ; 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
add (pane) ; 
for(x = 0; x < NUM; +4+x) 


{ 


panel[x] = new JPanelQ; 

pane.add(panel [x]); 

if( % COLS == 0) 

{ 
tempColor = color1; 
colorl = color2; 
color2 = tempColor; 





Figure 15-25 The Checkerboard class (continues) 
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(continued) 


if(x % 2 == 0) 
panel [x] .setBackground(color1) ; 


else 833 
panel [x] .setBackground(color2) ; 








} 

} 

public static void main(String[] args) 

{ 
Checkerboard frame = new CheckerboardQ); 
final int SIZE = 300; 
frame.setSize(SIZE, SIZE); 
frame.setVisible(true) ; 





Figure 15-26 Output of the Checkerboard application 
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When creating the Checkerboard class, you might be tempted to create just two JPanels, 
one blue and one white, and add them to the content pane multiple times. However, each 
GUI component can be contained only once. If a component is already in a container and you 
try to add it to another container, the component will be removed from the first container 
and then added to the second. 


ele) 
i) Watch the video The JPane] Class. 


834 





Using the JPanel Class 
1. A JPanel is a plain, borderless surface that can hold lightweight Ul components. 


2. To add a component to a JPanel, you call the component’s add() method, 
using the JPanel as the argument. 


3. Different JPanel constructors allow you to use default values or to specify a 
layout manager and whether the JPanel is double buffered. 
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Creating JScrol1Panes 


When components in a Swing UI require more display area than they have been allocated, 
you can use a JScro11Pane container to hold the components in a way that allows a user to 
scroll initially invisible parts of the pane into view. A JScrol1Pane provides scroll bars along 
the side or bottom of a pane, or both, with a viewable area called a viewport. Figure 15-27 
displays the inheritance hierarchy of the JScro11Pane class. 


java.lang.Object 
!__ java.awt.Component 
+--jJava.awt.Container 


!__javax.swing.JComponent 
!__4javax.swing.JScrollPane 





Figure 15-27 The inheritance hierarchy of the JScro11Pane class 
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The JScrol1Pane constructor takes one of four forms: 


e JScro11Pane() creates an empty JScrol1Pane in which both horizontal and vertical 
scroll bars appear when needed. 


e JScrol1Pane(Component) creates a JScrol1Pane that displays the contents of the 
specified component. 835 








e JScrol1Pane(Component, int, int) creates a JScrol1Pane that displays the specified 
component and includes both vertical and horizontal scroll bar specifications. 


e JScrol1PaneCint, int) creates a JScrol1Pane with both vertical and horizontal scroll 
bar specifications. 


When you create a simple scroll pane using the constructor that takes no arguments, as in the 
following example, horizontal and vertical scroll bars appear only if they are needed, that is, if 
the contents of the pane cannot be fully displayed without them: 


JScrol1]Pane aScrollPane = new JScrol1PaneQ; 


To force the display of a scroll bar, you can use class variables defined in the 
Scrol1PaneConstants class, as follows: 


Scrol1PaneConstants .HORIZONTAL_SCROLLBAR_AS_ NEEDED 
Scrol1PaneConstants .HORIZONTAL_SCROLLBAR_ALWAYS 
Scrol1]PaneConstants . HORIZONTAL_SCROLLBAR_NEVER 
Scrol1]PaneConstants.VERTICAL_SCROLLBAR_AS NEEDED 
Scrol1]1PaneConstants.VERTICAL_SCROLLBAR_ALWAYS 
Scrol1PaneConstants.VERTICAL_SCROLLBAR_NEVER 


For example, the following code creates a scroll pane that displays an image named picture, a 
vertical scroll bar, and no horizontal scroll bar: 


JScrol1lPane scroll = new JScrol1]Pane(picture, 
Scrol1PaneConstants.VERTICAL_SCROLLBAR_ALWAYS, 
Scrol1PaneConstants .HORIZONTAL_SCROLLBAR_NEVER) ; 


Figure 15-28 shows a JScro11Demo class in which a label with a large font is added to a panel. 
The scroll pane named scro11 includes the panel and two scroll bars. 


import javax.swing.*; 
import java.awt.*; 
public class JScrol1lDemo extends JFrame 


{ 


private JPanel panel = new JPanel(); 

private JScrollPane scroll = new JScrol1Pane(panel, 
Scrol1PaneConstants. VERTICAL _SCROLLBAR_ALWAYS, 
Scrol1PaneConstants .HORIZONTAL_SCROLLBAR_ALWAYS) ; 





Figure 15-28 The JScrol1Demo application (continues) 
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(continued) 


private JLabel label new JLabelC"Four score and seven"); 
private Font bigFont = new Font("Arial", Font.PLAIN, 20); 
836 private Container con; 

public JScrol1Demo() 

{ 





super("JScrol1Demo") ; 
setDefaul1tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
con = getContentPane(); 

label .setFont(bigFont) ; 

con.add(scrol1); 

panel .add(label) ; 


} 

public static void main(String[] args) 

{ 
final int WIDTH = 180; 
final int HEIGHT = 100; 
JScrollDemo aFrame = new JScrol1lDemoQ); 
aFrame.setSize(WIDTH, HEIGHT); 
aFrame.setVisible(true) ; 





Figure 15-28 The JScrol1Demo application 


The JScrol1Demo object in the program in Figure 15-28 is purposely set small enough 
(180 x 100) so that only part of the label it contains is visible at a time. A user can slide 
the scroll bars to view the entire label. Figure 15-29 shows the output with the scroll bar 
in two positions. 








Figure 15-29 Output of the JScrol1Demo application 
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Creating JScrol1Panes 


1. A JScro11Pane can provide scroll bars along the side or bottom of a pane, 837 
or both. 


2. When you create a simple scroll pane using the constructor that takes no 
arguments, horizontal and vertical scroll bars appear only if they are needed. 








3. You cannot force the display of a scroll bar in a JScro11Pane unless the 
components it contains require too much room. 
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A Closer Look at Events and Event Handling 


In the chapter Introduction to Swing Components, you worked with ActionEvents and 
ItemEvents that are generated when a user works with a control that is included in one of 
your programs. The parent class for all events is EventObject, which descends from the 
Object class. EventObject is the parent of AWTEvent, which in turn is the parent of specific 
event classes such as ActionEvent and ItemEvent. The abstract class AWTEvent is contained 
in the package java.awt.event. Although you might think it would have been logical for the 
developers to name the event base class Event, there is no currently active, built-in Java class 
named Event (although there was one in Java 1.0). Figure 15-30 illustrates the inheritance 
hierarchy of these relationships. 


java.lang.Object 
+--Jjava.util.Eventobject 
| _sava.awt .AWTEvent 
|__java.awt.event.ActionEvent 
+--java.awt.event .AdjustmentEvent 
+--java.awt.event.ItemEvent 
+--java.awt.event.TextEvent 
+--java.awt.event.ComponentEvent 
!__java.awt.event.ContainerEvent 
+--Java.awt.event.FocusEvent 
+--java.awt.event.PaintEvent 
+--java.awt.event.WindowEvent 
+--Java.awt.event.InputEvent 
+--java.awt.event.KeyEvent 
+--java.awt event .MouseEvent 





Figure 15-30 The inheritance hierarchy of event classes 
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You can see in Figure 15-30 that ComponentEvent is a parent to several event classes, 
including InputEvent, which is a parent of KeyEvent and MouseEvent. The family tree for 
events has roots that go fairly deep, but the class names are straightforward, and they share 
basic roles within your programs. For example, ActionEvents are generated by components 
that users can click, such as JButtons and JCheckBoxes, and TextEvents are generated by 
838 components into which the user enters text, such as a JTextField. MouseEvents include 
determining the location of the mouse pointer and distinguishing between a single- and 
double-click. Table 15-3 lists some common user actions and the events that are generated 








from them. 
User Action Resulting Event Type 
Click a button ActionEvent 
Click a component MouseEvent 
Click an item in a list box ItemEvent 
Click an item in a check box ItemEvent 
Change text in a text field TextEvent 
Open a window WindowEvent 
Iconify a window WindowEvent 
Press a key KeyEvent 


WE)) sie} ~=Examples of user actions and their resulting event types 


Because ActionEvents involve the mouse, it is easy to confuse ActionEvents and 
MouseEvents. If you are interested in ActionEvents, you focus on changes in a component 
(for example, a JButton on a JFrame being pressed); if you are interested in MouseEvents, 
your focus is on what the user does manually with the mouse (for example, clicking the left 
mouse button). 


When you write programs with GUIs, you are always handling events that originate with the 
mouse or keys on specific Components or Containers. Just as your telephone notifies you 
when you have a call, the computer’s operating system notifies the user when an AWTEvent 
occurs, for example, when the mouse is clicked. Just as you can ignore your phone when 
you're not expecting or interested in a call, you can ignore AwTEvents. If you don’t care about 
an event, such as when your program contains a component that produces no effect when 
clicked, you simply don’t look for a message to occur. 


When you care about events—that is, when you want to listen for an event—you can 
implement an appropriate interface for your class. Each event class shown in Table 15-3 has a 
listener interface associated with it, so that for every event class, <name>Event, there is a 
similarly named <name>Listener interface. For example, ActionEvent has an 
ActionListener interface. (The MouseEvent class has an additional listener besides 
MouseListener: MouseMotionListener.) 
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implement a listener, you must provide your own methods for all the methods that are part of the interface. 
Of course, you can leave the methods empty in your implementation, providing a header and curly braces but 
no statements. 


Q Remember that an interface contains only abstract methods, so all interface methods are empty. If you 


839 








Every <name>Listener interface method has the return type void, and each takes one 
argument: an object that is an instance of the corresponding <name>Event class. Thus, the 
ActionListener interface has an event handler method named actionPerformed(), and its 
header is void actionPerformed(ActionEvent e). When an action takes place, the 
actionPerformed() method executes, and e represents an instance of that event. Instead of 
implementing a listener class, you can extend an adapter class. An adapter class implements 
all the methods in an interface, providing an empty body for each method. For example, the 
MouseAdapter class provides an empty method for all the methods contained in 
MouseListener. The advantage to extending an adapter class instead of implementing a 
listener class is that you need to write only the methods you want to use, and you do not have 
to bother creating empty methods for all the others. (If a listener has only one method, there 
is no need for an adapter. For example, the ActionListener class has one method, 
actionPerformed(), so there is no ActionAdapter class.) 


Whether you use a listener or an adapter, you create an event handler when you write 
code for the listener methods; that is, you tell your class how to handle the event. After 
you create the handler, you must also register an instance of the class with the component 
that you want the event to affect. For any <name>Listener, you must use the form 
object.add<name>Listener (Component) to register an object with the Component that will 
listen for objects emanating from it. The add<name>Listener() methods, such as 
addActionListener() and addItemListener(), all work the same way. They register a 
listener with a Component, return void, and take a <name>Listener object as an argument. 
For example, if a JFrame is an ActionListener and contains a JButton named pushMe, then 
the following statement registers this JFrame as a listener for the pushMe JButton: 


pushMe. addActionListener (this) ; 


Table 15-4 lists the events with their listeners and handlers. 
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Event Listener(s) Handler(s) 
ActionEvent ActionListener actionPerformed(ActionEvent) 
ItemEvent ItemListener itemStateChanged(ItemEvent) 
840 TextEvent TextListener textValueChanged(TextEvent) 
AdjustmentEvent AdjustmentListener adjustmentValueChanged 
(AdjustmentEvent) 
ContainerEvent ContainerListener componentAdded(ContainerEvent) 


componentRemoved(ContainerEvent) 


ComponentEvent ComponentListener componentMoved (ComponentEvent) 
componentHi dden(ComponentEvent) 
componentResi zed (ComponentEvent) 
componentShown (ComponentEvent) 


FocusEvent FocusListener focusGained(FocusEvent) 
focusLost (FocusEvent) 


MouseEvent MouseListener mousePressed (MouseEvent) 
MouseMotionListener mouseReleased(MouseEvent) 
mouseEntered(MouseEvent) 

mouseEx7i ted (MouseEvent) 
mouseClicked(MouseEvent) 
mouseDragged (MouseEvent) 

mouseMoved(MouseEvent) 


KeyEvent KeyListener keyPressed(KeyEvent) 
keyTyped(KeyEvent) 
keyReleased(KeyEvent) 


WindowEvent WindowListener windowActi vated (Wi ndowEvent) 
windowClosing(WindowEvent) 
windowClosed(WindowEvent) 
windowDei coni fi ed(WindowEvent) 
windowIconi fied (windowEvent) 
windowOpened (Wi ndowEvent) 


MouseWheelEvent MouseWheelListener mouseWhee IMoved (MouseWheel Event) 


Wel) kee) ~=Events with their related listeners and handlers 


An Event-Handling Example: KeyListener 


You use the KeyListener interface when you are interested in actions the user initiates 
from the keyboard. The KeyListener interface contains three methods: keyPressed(), 
keyTyped(), and keyReleased(). For most keyboard applications in which the user must 
press a keyboard key, it is probably not important whether you take resulting action when a 
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user first presses a key, during the key press, or upon the key’s release; most likely, these 
events occur in quick sequence. However, on those occasions when you don’t want to take 
action while the user holds down the key, you can place the actions in the keyReleased() 
method. It is best to use the keyTyped() method when you want to discover which character 
was typed. When the user presses a key that does not generate a character, such as a function 
key (sometimes called an action key), keyTyped() does not execute. The methods 841 
keyPressed() and keyReleased() provide the only ways to get information about keys that 

don’t generate characters. The KeyEvent class contains constants known as virtual key codes 

that represent keyboard keys that have been pressed. For example, when you type A, two 

virtual key codes are generated: Shift and “a”. The virtual key code constants have names such 

as VK_SHIFT and VK_ALT. See the Java Web site for a complete list of virtual key codes. 

Figure 15-31 shows a JDemoKeyFrame class that uses the keyTyped() method to discover 

which key the user typed last. 








platform or keyboard layout. (For example, the key that generates VK_Q on a U.S. keyboard layout 
generates VK_A on a French keyboard layout.) In contrast, keyPressed() and keyReleased() 
events are “lower-level” events and do depend on the platform and keyboard layout. According to the 
Java documentation, using keyTyped() is the preferred way to find out about character input. 


Q Java programmers call keyTyped() events “higher-level” events because they do not depend on the 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
public class JDemoKeyFrame extends JFrame 
implements KeyListener 
{ 
private JLabel prompt = new JLabel("Type keys below:"); 
private JLabel outputLabel = new JLabel(); 
private JTextField textField = new JTextField(10); 
public JDemoKeyFrame() 
{ 
setTitle("JKey Frame"); 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setLayout(new BorderLayout()); 
add(prompt, BorderLayout.NORTH) ; 
add(textField, BorderLayout.CENTER) ; 
add(outputLabel, BorderLayout.SOUTH) ; 
addKeyListener(this) ; 
textField.addKeyListener(this) ; 
} 
public void keyTyped(KeyEvent e) 
{ 


char c = e.getKeyChar(); 
outputLabel.setText("Last key typed: 


+ C)3 





Figure 15-31 The JDemoKeyFrame class (continues) 
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(continued) 


public void keyPressed(KeyEvent e) 
{ 
842 } 
public void keyReleased(KeyEvent e) 
{ 
} 


public static void main(String[] args) 





t 
JDemoKeyFrame keyFrame = new JDemoKeyFrame() ; 
final int WIDTH = 250; 
final int HEIGHT = 100; 
keyFrame.setSize(WIDTH, HEIGHT); 
keyFrame.setVisible(true) ; 





Figure 15-31 The JDemoKeyFrame class 


A prompt in the north border area asks the user to type in the text field in the center area. 
With each key press by the user, the keyTyped() method changes the label in the south 
border area of the frame to display the key that generated the most recent KeyEvent. 
Figure 15-32 shows the output after the user has typed several characters into the text field. 





Figure 15-32 Output of the JDemoKeyFrame application after the user has typed several characters 


ee 
eau Watch the video Event Handling. 
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Using AWTEvent Class Methods 


A Closer Look at Events and Event Handling 


1. ActionEvents are generated by components that users can click, TextEvents 843 
are generated by components into which the user enters text, and MouseEvents 
are generated by mouse actions. 








2. Every <name>Listener interface method has a return type that refers to an 
instance of the corresponding <name>Event Class. 


3. An adapter class implements all the methods in an interface, providing an empty 
body for each method. 
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Using AwTEvent Class Methods 


In addition to the handler methods included with the event listener interfaces, the AWTEvent 
classes themselves contain many other methods that return information about an event. For 
example, the ComponentEvent class contains a getComponent() method that allows you to 
determine which of multiple Components generates an event. The WindowEvent class contains 
a similar method, getWindow(), that returns the Window that is the source of an event. 
Table 15-5 lists some useful methods for many of the event classes. All Components have 
these methods: 


e addComponentListener() 
e addFocusListener() 
e addMouseListener() 


e addMouseMotionListener() 
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Class Method Purpose 

EventObject Object getSource() Returns the Object involved in the event 

ComponentEvent Component getComponent() Returns the Component involved in the event 

844 WindowEvent Window getWindow() Returns the Window involved in the event 

ItemEvent Object getItem() Returns the Object that was selected or 
deselected 

ItemEvent int getStateChange() Returns an integer named 
ItemEvent.SELECTED or 
ItemEvent .DESELECTED 

InputEvent int getModifiersQ Returns an integer to indicate which mouse 
button was clicked 

InputEvent int getwhenQ Returns a time indicating when the event 
occurred 

InputEvent boolean isA1tDown() Returns whether the Alt key was pressed when 
the event occurred 

InputEvent boolean isControlDown() _ Returns whether the Ctrl key was pressed 
when the event occurred 

InputEvent boolean isShiftDown() Returns whether the Shift key was pressed 
when the event occurred 

KeyEvent int getKeyCharQ Returns the Unicode character entered from 
the keyboard 

MouseEvent int getClickCountQ Returns the number of mouse clicks; lets you 
identify the user’s double-clicks 

MouseEvent int getXx() Returns the x-coordinate of the mouse pointer 

MouseEvent int getYO Returns the y-coordinate of the mouse pointer 

MouseEvent Point getPointQ) Returns the Point Object that contains the x- 


and y-coordinates of the mouse location 


Wels) Useful event class methods 


You can call any of the methods listed in Table 15-5 by using the object-dot-method format 
that you use with all class methods. For example, if you have a KeyEvent named inputEvent 
and an integer named unicodeVal, the following statement is valid: 


unicodeVal = inputEvent.getKeyChar() ; 


When you use an event, you can use any of the event’s methods, and through the power of 
inheritance, you can also use methods that belong to any superclass of the event. For example, 
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Using AWTEvent Class Methods 


any KeyEvent has access to the InputEvent, ComponentEvent, AwTEvent, EventObject, and 
Object methods, as well as to the KeyEvent methods. 


Understanding x- and y-Coordinates 


Table 15-5 refers to x- and y-coordinates of a mouse pointer. A window or frame consists of 
a number of horizontal and vertical pixels on the screen. Any component you place on the 
screen has a horizontal, or x-axis, position as well as a vertical, or y-axis, position in the 
window. The upper-left corner of any display is position 0, 0. The first, or x-coordinate, 
value increases as you travel from left to right across the window. The second, or 
y-coordinate, value increases as you travel from top to bottom. Figure 15-33 illustrates 
some screen coordinate positions. 


845 




















Figure 15-33 Screen coordinate positions 


Using AWTEvent Class Methods 


1. You use many of the AwTEvent class methods to determine the nature of and 
facts about an event. 


2. The getSource( method returns the Object involved in an event, and the 
getComponent() method returns the Component involved in an event. 


3. The methods isAltDown() and isShiftDown() are ActionEvent methods. 
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Handling Mouse Events 


Even though Java program users sometimes type characters from a keyboard, when you 
write GUI programs you probably expect users to spend most of their time operating a 
mouse. The MouseMotionListener interface provides you with methods named 

846 mouseDragged() and mouseMoved() that detect the mouse being rolled or dragged across a 





component surface. The MouseListener interface provides you with methods named 


mousePressed(), mouseClicked(), and mouseReleased() that are analogous to the keyboard 
event methods keyPressed(), keyTyped(), and keyReleased(). With a mouse, however, you 
are interested in more than its button presses; you sometimes simply want to know where a 
mouse is pointing. The additional interface methods mouseEntered() and mouseExited() 
inform you when the user positions the mouse over a component (entered) or moves the 
mouse off a component (exited). The MouseInputListener interface implements all the 
methods in both the MouseListener and MouseMotionListener interfaces; although it has no 
methods of its own, it is a convenience when you want to handle many different types of 
mouse events. Tables 15-6 and 15-7 show the methods of the MouseListener and 
MouseMotionListener classes, respectively. 


Method 


Description 





void mouseClicked(MouseEvent e) 


void mouseEntered(MouseEvent e) 
void mouseExited(MouseEvent e) 


void mousePressed(MouseEvent e) 


void mouseReleased(MouseEvent e) 


WEEMS) MouseListener methods 


Invoked when the mouse button has been clicked 
(pressed and released) on a component 


Invoked when the mouse pointer enters a component 
Invoked when the mouse pointer exits a component 


Invoked when a mouse button has been pressed on a 
component 


Invoked when a mouse button has been released on a 
component 


by interface here so you can better understand the scope of methods that are available for mouse actions. 


Q Many of the methods in Tables 15-6 and 15-7 also appear in tables earlier in this chapter. They are organized 


Don’t forget that because MouseListener, MouseMotionListener, and MouseInputListener 
are interfaces, you must include each method in every program that implements them, even if you choose to 
place no instructions within some of the methods. 
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Method Description 





void mouseDragged(MouseEvent e) Invoked when a mouse button is pressed on a 
component and then dragged 


void mouseMoved(MouseEvent e) Invoked when the mouse pointer has been moved 


847 
onto a component but no buttons have been pressed 








Ve) ~=MouseMotionListener methods 


The MouseWheelListener interface contains just one method named mouseWhee1Moved(), and it 
Y accepts a MouseWheelEvent argument. 


Each of the methods in Tables 15-6 and 15-7 accepts a MouseEvent argument. A MouseEvent 
is the type of event generated by mouse manipulation. Figure 15-34 shows the inheritance 
hierarchy of the MouseEvent class. From this diagram, you can see that a MouseEvent is a 
type of InputEvent, which is a type of ComponentEvent. The MouseEvent class contains 
many instance methods and fields that are useful in describing mouse-generated events. 
Table 15-8 lists some of the more useful methods of the MouseEvent class, and Table 15-9 
lists some fields. 


java.lang.Object 
|__4ava.util.EventObject 
|__java.awt.AWTEvent 


|__java.awt.event.ComponentEvent 


|__4ava.awt.event.InputEvent 
+-- java.awt.event.MouseEvent 





Figure 15-34 The inheritance hierarchy of the MouseEvent class 


Method Description 


int getButton() Returns which, if any, of the mouse buttons has changed state; uses fields 
NOBUTTON, BUTTON1, BUTTON2, and BUTTON3 


int getClickCount() Returns the number of mouse clicks associated with the current event 


int getxQd) Returns the horizontal x-position of the event relative to the source 
component 
int getYQO Returns the vertical y-position of the event relative to the source component 


JE) S:) Some useful MouseEvent methods 
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Field Description 

static int BUTTON1 Indicates mouse button #1; used by getButton() 

static int BUTTON2 Indicates mouse button #2; used by getButton() 
848 static int BUTTON3 Indicates mouse button #3; used by getButton() 

static int NOBUTTON Indicates no mouse buttons; used by getButton() 

static int MOUSE CLICKED The “mouse clicked” event 

static int MOUSE_DRAGGED The “mouse dragged” event 

static int MOUSE ENTERED The “mouse entered” event 

static int MOUSE EXITED The “mouse exited” event 


Wl) (9S!) Some useful MouseEvent fields 


Figure 15-35 shows a JMouseActionFrame application that demonstrates several of the 
mouse listener and event methods. JMouseActionFrame extends JFrame, and because it 
implements the MouseListener interface, it must include all five methods—mouseClickedQ, 
mouseEntered(), mouseExited(), mousePressed(), and mouseReleased()—even though no 
actions are included in the mousePressed() or mouseReleased() methods. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
public class JMouseActionFrame extends JFrame implements MouseListener 
{ 
private int x, y; 
private JLabel label= new JLabel("Do something with the mouse"); 


woe 


String msg = : 


public JMouseActionFrame() 


{ 


setTitleC"Mouse Actions"); 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setLayout(new FlowLayout()); 
addMouseListener(this); 

add(label); 





Figure 15-35 The JMouseActionFrame application (continues) 
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(continued) 


public void mouseClicked(MouseEvent e) 
{ 
int whichButton = e.getButtonQ ; 
msg = "You pressed mouse "; 849 
if(whichButton == MouseEvent.BUTTON1) 
msg += "button 1."; 
else 
if(whichButton == MouseEvent.BUTTON2) 
msg += "button 2."; 
else 
msg += "button 3."; 
msg += " You are at position " + 
e.getXQ) +", "+ e.getYQ + "."5 
if(e.getClickCountQ) == 2) 
msg += " You double-clicked."; 
else 
msg += " You single-clicked."; 
label.setText(msg) ; 








} 
public void mouseEntered(MouseEvent e) 
{ 
msg = "You entered the frame."; 
label.setText(msg) ; 
} 
public void mouseExited(MouseEvent e) 
{ 
msg = "You exited the frame."; 
label.setText(msg) ; 
} 


public void mousePressed(MouseEvent e) 


{ 
} 


public void mouseReleased(MouseEvent e) 

{ 

} 

public static void main(String[] args) 

{ 
JMouseActionFrame mFrame = new JMouseActionFrame(); 
final int WIDTH = 750; 
final int HEIGHT = 300; 
mFrame.setSize(WIDTH, HEIGHT); 
mFrame.setVisible(true) ; 





Figure 15-35 The JMouseActionFrame application 
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The JMouseActionFrame application in Figure 15-35 displays messages as the user generates 

mouse actions. At the start of the class, two integers are declared to hold the mouse 

position x- and y-coordinates. A JLabel and a String are also declared to hold messages 

that inform the user of the mouse actions taken. In the first shaded section of Figure 15-35, 

the constructor sets a frame title by passing it to the parent of JMouseActionFrame, sets a 

850 close operation, sets the layout manager, enables the frame to listen for mouse events, and 
adds the JLabel to the JFrame. 





In Figure 15-35, most of the action occurs in the mouseClicked() method (the second 
unshaded area in the figure). The method builds a String that is ultimately assigned to 

the JLabel. The same actions could have been placed in the mousePressed() or 
mouseReleased() method because the statements could be placed in the frame just as well 
at either of those times. Within the mouseClicked() method, the MouseEvent object named 
e is used several times. It is used with the getButton() method to determine which mouse 
button the user clicked, getXQ and getY() are used to retrieve the mouse position, and 
getClickCount() is used to distinguish between single- and double-clicks. 


In Figure 15-35, different messages also are generated in the mouseEntered() and 
mouseExited() methods, so the user is notified when the mouse pointer has “entered”—that 
is, passed over the surface area of—the JFrame, the component that is listening for actions. 


The main© method at the end of the class creates one instance of the JMouseActionFrame 
class and sets its size and visibility. 


Figure 15-36 shows the JMouseActionFrame application during execution. At this point, the 
user has just clicked the left mouse button near the upper-right corner of the frame. Of 
course, in your own applications you might not want only to notify users of their mouse 
actions; instead, you might want to perform calculations, create files, or generate any other 
programming tasks. 





& 
Le 





You pressed mouse button 1. You are at position 689, 67. You single-clicked. 











Figure 15-36 Typical execution of the JMouseActionFrame application 
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Handling Mouse Events 


1. The MouseMotionListener interface provides you with methods that detect the 851 
mouse being rolled or dragged across a component surface. 








2. The MouseListener interface provides you with methods that are analogous to 
the keyboard event methods keyPressed(), keyTyped(), and keyReleased(). 


3. The MouseListener interface implements all the methods in the 
MouseInputListener interface. 
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Using Menus 


Menus are lists of user options; they are commonly added features in GUI programs. 
Application users are used to seeing horizontal menu bars across the tops of frames, and 
they expect to be able to click those options to produce drop-down lists that display more 
choices. The horizontal list of JMenus is a JMenuBar. Each JMenu can contain options, called 
jJMenuItems, or can contain submenus that also are JMenus. For example, Figure 15-37 shows 
a JFrame that illustrates the use of the following components: 


e A JMenuBar that contains two JMenus named File and Colors. 


e Three items within the Colors JMenu: Bright, Dark, and White. Dark and White are 
JMenultems. Bright is a JMenu that holds a submenu. You can tell that Bright is a 
submenu because an arrow sits to the right of its name, and when the mouse hovers over 
Bright, two additional JMenuItems appear: Pink and Yellow. 
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Figure 15-37 A JFrame with a horizontal JMenuBar that holds two JMenus 


To create the output shown in Figure 15-37, a series of JMenuBar, JMenu, and JMenuItem 
objects were created and put together in stages. You can create each of the components you 
see in the menus in Figure 15-37 as follows: 


e You can create a JMenuBar much like other objects—by using the new operator and a call 
to the constructor, as follows: 


JMenuBar mainBar = new JMenuBar(); 
e You can create the two JMenus that are part of the JMenuBar: 


JMenu menul = new JMenu("File"); 
JMenu menu2 = new JMenuC"Colors"); 


e The three components within the Colors JMenu are created as follows: 


JMenu bright = new JMenuC("Bright") ; 
JMenuItem dark = new JMenuItemC("Dark"); 
JMenuItem white = new JMenultem("White"); 


@ 
a 


he two JMenuItems that are part of the Bright JMenu are created as follows: 


= 


MenuItem pink = new JMenulItemC("Pink") ; 
MenuItem yellow = new JMenuItem("Yel low") ; 





= 


Once all the components are created, you assemble them. 
e You add the JMenuBar to a JFrame using the setJMenuBar() method as follows: 


setJMenuBar (mainBar) ; 
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Using the setJMenuBar() method assures that the menu bar is anchored to the top of the 
frame and looks like a conventional menu bar. Notice that the JMenuBar is not added to a 
JFrame’s content pane; it is added to the JFrame itself. 


e The JMenus are added to the JMenuBar using the add() method. For example: 


mainBar.add(menul) ; 853 


mainBar.add(menu2) ; 








e A submenu and two JMenuItems are added to the Colors menu as follows: 


menu2.add(bright) ; 
menu2.add(dark) ; 
menu2.add(white) ; 


e Asubmenu can contain its own JMenuItems. For example, the Bright JMenu that is part of 
the Colors menu in Figure 15-37 contains its own two JMenuItem objects: 


bright.add(pink) ; 
bright.add(yel low); 


Figure 15-38 shows a complete working program that creates a frame with a greeting and the 
JMenu shown in Figure 15-37. 


import javax.swing.*; 

import java.awt.*; 

import java.awt.event.*; 

import java.awt.Color; 

public class JMenuFrame extends JFrame implements 
ActionListener 

{ 
private 
private 


JMenuBar mainBar = new JMenuBar(); 
JMenu menul = new JMenuC("File"); 
private JMenu menu2 = new JMenuC"Colors"); 
private JMenuItem exit = new JMenuItemC"Exit"); 
private JMenu bright = new JMenuC"Bright"); 
private JMenuItem dark = new JMenuItemC("Dark") ; 
private JMenuItem white = new JMenuItem("White") ; 
private JMenuItem pink = new JMenuItemC("Pink") ; 
JMenuItem yellow = new JMenuItemC("Yel low") ; 





private 
private JLabel label = new JLabel("Hello"); 





Figure 15-38 The JMenuFrame class (continues) 
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(continued) 


public JMenuFrame() 
{ 
setTitleC"Menu Demonstration") ; 

854 setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setLayout(new FlowLayout()); 
setJMenuBar (mainBar) ; 
mainBar.add(menul) ; 
mainBar.add(menu2) ; 
menul.add(exit) ; 
menu2.add(bright) ; 
menu2.add(dark) ; 
menu2.add(white) ; 
bright.add (pink) ; 
bright.add(yel low) ; 
exit.addActionListener(this) ; 
dark.addActionListener(this) ; 
white.addActionListener(this) ; 
pink.addActionListener(this) ; 
yellow. addActionListener(this) ; 
add(label); 
label.setFont(new FontC"Arial", Font.BOLD, 26)); 





I 


public void actionPerformed(ActionEvent e) 


{ 
Object source = e.getSource(); 
Container con = getContentPane() ; 
if(source == exit) 
System.exit(0); 
else if(source == dark) 
con. setBackground(Color.BLACK) ; 
else if(source == white) 
con. setBackground(Color.WHITE) ; 
else if(source == pink) 
con.setBackground(Color. PINK) ; 
else con.setBackground(Color. YELLOW) ; 
} 


public static void main(String[] args) 

{ 
JMenuFrame mFrame = new JMenuFrame(); 
final int WIDTH = 250; 
final int HEIGHT = 200; 
mFrame.setSize(WIDTH, HEIGHT); 
mFrame.setVisible(true) ; 





Figure 15-38 The JMenuFrame class 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


In the application in Figure 15-38, each JMenuItem becomes a source for an ActionEvent, and 
the JFrame is assigned the role of listener for each. The actionPerformed() method 

determines the source of any generated event. If the user selects the Exit option from the File 
menu, the application ends. If the user selects any of the colors from the Colors menu, the 
background color of the JFrame is altered accordingly. 855 








Using JCheckBoxMenuItem and 
JRadioButtonMenultem Objects 


The JCheckBoxMenuItem and JRadioButtonMenultem classes derive from the JMenuItem 
class. Each provides more specific menu items as follows: 


e JCheckBoxMenuItem objects appear with a check box next to them. An item can be 
selected (displaying a check mark in the box) or not. Usually, you use check box items to 
turn options on or off. 


e JRadioButtonMenuItem objects appear with a round radio button next to them. Users 
usually expect radio buttons to be mutually exclusive, so you usually make radio buttons 
part of a ButtonGroup. Then, when any radio button is selected, the others are all 
deselected. 


The state of a JCheckBoxMenuItem or JRadioButtonMenuItem can be determined with the 
isSelected() method, and you can alter the state of the check box with the setSelected() 
method. 


Figure 15-39 shows a JMenuFrame2 application in which two JCheckBoxMenuItems and 
three JRadioButtonMenuItems have been added to a JMenu. The controls have not yet been 
assigned any tasks, but Figure 15-40 shows how the menu looks when the application 
executes. 


import javax.swing.*; 

import java.awt.*; 

import java.awt.event.*; 

public class JMenuFrame2 extends JFrame 


if 


private JMenuBar mainBar = new JMenuBar(); 
private JMenu menul = new JMenu("File"); 
private JCheckBoxMenuItem checkl = new 
JCheckBoxMenuItemC("Check box A"); 
private JCheckBoxMenuItem check2 = new 
JCheckBoxMenuItemC("Check box B"); 





Figure 15-39 The JMenuFrame2 application (continues) 
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(continued) 


private JRadioButtonMenuItem radiol = new 

JRadioButtonMenultem("Radio option 1"); 

private JRadioButtonMenuItem radio2 = new 

856 JRadioButtonMenultem("Radio option 2"); 

private JRadioButtonMenuItem radio3 = new 

JRadioButtonMenultem("Radio option 3"); 
private ButtonGroup group = new ButtonGroup() ; 





public JMenuFrame2() 

{ 
setTitleC"Menu Demonstration") ; 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setLayout(new FlowLayout()); 
setJMenuBar(mainBar) ; 
mainBar.add(menul) ; 
menul.add(Ccheck1) ; 
menul.add(Ccheck2) ; 


menul.addSeparator(); 
menul.add(Cradio1) ; 
menul.add(radio2) ; 
menul.add(radio3) ; 
group.add(radiol1) ; 
group.add(radio2) ; 
group. add(radio3) ; 


} 


public static void main(String[] args) 

{ 
JMenuFrame2 frame = new JMenuFrame2(); 
final int WIDTH = 150; 
final int HEIGHT = 200; 
frame.setSize(WIDTH, HEIGHT); 
frame.setVisible(true) ; 





Figure 15-39 The JMenuFrame2 application 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Using Mersin 


857 








J Check box A 
J Check box B 


C) Radio option 1 


“! Radio option 2 





Figure 15-40 Execution of the JMenuFrame2 application 


Using addSeparator() 


The shaded statement in Figure 15-39 calls the addSeparator() method. This method adds a 
horizontal line to menus in order to visually separate groups for your users. In Figure 15-40, 
you can see that the separator falls between the JCheckBoxMenuItems and the 
JRadioButtonMenultems because that’s the order in which the shaded addSeparator () 
method call was made. The separator does not change the functionality of the menu; it simply 
makes the menu more visually organized for the user. 


Using setMnemonic() 


A mnemonic is a key that causes an already visible menu item to be chosen. You can use the 
setMnemonic() method to provide a shortcut menu key for any visible menu item. For 
example, when you add the following statement to the JMenuFrame2 constructor in Figure 15- 
39, the menu appears as in Figure 15-41: 


menul.setMnemonic('F'); 


The mnemonic for the File menu is set to F, so the F in File is underlined. When a user 
presses Alt+F on the keyboard, the result is the same as if the user had clicked File on the 
menu: the menu list is opened and displayed. 
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Figure 15-41 The File menu with a mnemonic applied 


Your downloadable student files contain a JMenuFrame3 application that includes the setMnemonic(Q) 
YD instruction that produces the output in Figure 15-41. 


You should use a different mnemonic for each menu item that has one; if you use the same 
mnemonic multiple times, only the first assignment works. Usually, you use the first letter of 
the option—for example, F for File. If multiple menu items start with the same letter, the 
convention is to choose the next most prominent letter in the name. For example, X is often 
chosen as the mnemonic for Exit. 


An accelerator is similar to a mnemonic. It is a key combination that causes a menu item to 
be chosen whether or not it is visible. For example, many word-processing programs allow 
you to press Ctrl+P to print from anywhere in the program. Only leaf menu items—menus 
that don’t bring up other menus—can have accelerators. (They are called “leaves” because 
they are at the end of a branch with no more branches extending from them.) See the Java 
Web site for more details. 
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Using Menus 


1. The horizontal list of JMenus at the top of a JFrame is a JMenu. 859 








2. Each JMenu can contain options, called JMenuItems, or it can contain submenus 
that also are JMenus. 


3. You add a JMenuBar to a JFrame using the setJMenuBar() method. 
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<n You Do It 


Using a Menu Bar and JPanels 


Next, you create an application for a party planning company that uses a menu bar 
with multiple user options, and that uses separate JPane1s with different layout 
managers to organize components. 


1. Open a new file in your text editor, and enter the following first few lines of 
the EventSelector Class. The class extends JFrame and implements 
ActionListener because the JFrame contains potential user mouse 
selections. 


import javax.swing.*; 

import java.awt.*; 

import java.awt.event.*; 

import java.awt.Color; 

public class EventSelector extends JFrame implements ActionListener 


{ 
2. Create a JMenuBar and its two JMenus as follows: 


private JMenuBar mainBar = new JMenuBar(); 
private JMenu menul = new JMenu("File"); 
private JMenu menu2 = new JMenuC"Event types"); 


(continues) 
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(continued) 


3. Next, create the items that will appear within the menus. The File menu contains 
an Exit option. The Event types menu contains two submenus: Adult and Child. 
860 Each of those submenus contains more options. For example, Figure 15-42 
shows the expanded Adult event types menu in the finished program. 





private JMenuItem exit = new JMenulItem("Exit”"); 

private JMenu adult = new JMenu("Adult") ; 

private JMenu child = new JMenu("Child"); 

private JMenuItem adultBirthday = new JMenultem("Birthday”") ; 
private JMenuItem anniversary = new JMenulItem("Anniversary") ; 
private JMenuItem retirement = new JMenuItem("Retirement") ; 
private JMenuItem adultOther = new JMenuItem("Other") ; 
private JMenuItem childBirthday = new JMenultem("Birthday”") ; 
private JMenuItem childOther = new JMenuItem("Other") ; 


Adult >) Birthday 
Child >| Anniversary 





S are our specialty 


Wi Retirement as for memorable events 


Lats () Casual events 








Figure 15-42 The Adult menu 


4. Declare several other components that will be used to show how JFrames are 
composed: 


private JPanel birthdayPanel = new JPanel(); 
private JPanel otherPanel = new JPanel (); 
private JLabel birthdayLabel = new 
JLabel ("Birthday events are our specialty"); 
private JLabel otherLabel = new 
JLabel("We have lots of ideas for memorable events"); 
private JPanel buttonPanel = new JPanel(); 
private JRadioButton radButtonl = new 
JRadioButton("Formal events"); 
private JRadioButton radButton2 = new 
JRadioButton("Casual events"); 


(continues) 
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(continued) 
5. Write the constructor for the JFrame. Set the title, the default close operation, 
and the layout. Call separate methods to compose the menu, to add the 
necessary action listeners to the menu items, and to lay out the JFrame’s 
components. These tasks could be performed directly within the constructor, 
but you can place them in separate methods to better organize the application. 
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public EventSelector() 
{ 
setTitleC("Event Selector"); 
setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE); 
setLayout (new FlowLayout()); 
composeMenus () ; 
addActionListenersQ); 
layoutComponents() ; 


} 


6. Add the composeMenus() method. Set the main menu bar, and add two menus to 
it. Then add one option to the first menu and two submenus to the second menu. 
Finally, add four items to the first submenu and two items to the other one. 


public void composeMenus() 

{ 
setJMenuBar (mainBar) ; 
mainBar.add(menul) ; 
mainBar.add(menu2) ; 
menul.add(exit) ; 
menu2.add(adult) ; 
menu2.add(child); 
adult.add(adultBirthday) ; 
adult.add(anniversary) ; 
adult.add(retirement) ; 
adult .add(adultOther) ; 
child.add(childBirthday) ; 
child.add(childOther) ; 

} 


7. Add the addActionListeners() method, which makes the JFrame become a 
listener for each menu item: 


public void addActionListeners() 

{ 
exit.addActionListener(this) ; 
adultBirthday.addActionListener (this) ; 
anniversary .addActionListener(this) ; 
retirement .addActionListener(this) ; 
adultOther.addActionListener(this) ; 
childBirthday.addActionListener (this) ; 
childOther.addActionListener(this) ; 


(continues) 
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(continued) 


8. The layoutComponents() method arranges all the components that appear 


in the content pane. The birthdayPanel object contains a single label. The 
otherPanel object contains a label and another panel (buttonPanel) in a 

grid. The buttonPanel contains two radio buttons. For this demonstration, the 
radio buttons are not functional, but in a more complicated application, an 
addActionListener() method could be applied to them. Also, in a more 
complicated application, you could continue to place panels within another 
panel to achieve complex designs. 


public void layoutComponents() 

{ 
birthdayPanel .setLayout(new FlowLayout()) ; 
otherPanel .setLayout(new GridLayout(2, 1, 3, 3)); 
birthdayPanel .add(birthdayLabel) ; 
otherPanel .addC"other", otherLabel) ; 
otherPanel .addC("buttons", buttonPanel); 
buttonPanel .add(radButton1) ; 
buttonPanel .add(radButton2) ; 
add(birthdayPanel) ; 
add(otherPanel); 

} 


Add an actionPerformed() method that responds to menu selections. 
Different background colors are set depending on the user’s choices. 


public void actionPerformed(ActionEvent e) 
{ 
Object source e.getSource() ;5 
Container con = getContentPane() ; 
if(source == exit) 
System.exit(0); 
else if(source == childBirthday || source == childOther) 
con. setBackground(Color.PINK) ; 
else 
con.setBackground(Color.WHITE) ; 
if(source == adultBirthday || source == childBirthday) 
{ 


birthdayPanel .setBackground(Color. YELLOW) ; 
otherPanel . setBackground(Color.WHITE) ; 
} 


else 
birthdayPanel .setBackground(Color.WHITE) ; 


otherPanel . setBackground(Color. YELLOW) ; 
} 


(continues) 
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(continued) 


10. Add the main method, which instantiates an EventSelector object and sets its 
size and visibility. Add a closing curly brace for the class. 863 








public static void main(String[] args) 

{ 
EventSelector frame = new EventSelector(); 
final int WIDTH = 400; 
final int HEIGHT = 200; 
frame.setSize(WIDTH, HEIGHT); 
frame.setVisible(true) ; 


} 


11. Save the application as EventSelector.java, and then compile and run it. 
Make various selections and observe the effects. Figure 15-43 shows the 
running application after the user has made some selections. After you 
experiment with the application, dismiss the frame. 


File Event types 





Birthday events are our specialty 


We have lots of ideas for memorable events 


®) Formal events) “ Casual events 





Figure 15-43 The EventSelector application 


12. Experiment by making changes to the EventSelector application. For example, 
some menu selections could change the JFrame background to a different color, 
and others could add a new JLabel to the JFrame content pane. 
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Don't Do It 


e Don't forget that the content pane is operating behind the scenes when you use a top-level 
container and that, depending on the operations you want to perform, you might need to 
get a reference to it. 


e Don't forget that when you create a custom Color object, 0 represents the darkest shade 
and 255 represents the lightest. 


e Don't forget to set a layout manager if you do not want to use the default one for a 
container. 


e Don't use add() to place a JFrame’s menu bar. You must use the setMenuBar() method to 
place a menu bar correctly. 


e Don't use the same mnemonic for multiple menu items. 










Key Terms 


A top-level container is one at the top of a containment hierarchy. The Java top-level 
containers are JFrame, JDialog, and JApplet. 


A containment hierarchy is a tree of components that has a top-level container as its root 
(that is, at its uppermost level). 


A content pane contains all the visible components in a top-level container’s user interface. 


A menu bar is a horizontal strip that is placed at the top of a container and that contains user 
options. 


A glass pane resides above the content pane in a container. It can contain tool tips. 
The getContentPane() method returns a reference to a container’s content pane. 
The Color class defines colors for you to use in your applications. 


The BorderLayout manager is the default manager class for all content panes. With the 
BorderLayout manager, components fill the screen in five regions: north, south, east, west, 
and center. 


The FlowLayout manager arranges components in rows across the width of a Container; 
when the current row is filled, additional Components are placed in new rows. 


The preferred size of a Component is its default size. 


The GridLayout manager divides a container surface into a grid. 
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The CardLayout manager generates a stack of containers or components, one on top of 
another. 


The GridBagLayout manager allows you to add Components to precise locations within the 
grid, as well as to indicate that specific Components should span multiple rows or columns 
within the grid. 865 








The BoxLayout manager allows multiple components to be laid out either vertically or 
horizontally. The components do not wrap, so a vertical arrangement of components, for 
example, stays vertically arranged when the frame is resized. 


A JPanel is a plain, borderless surface that can hold lightweight UI components. 


Double buffering is the default buffering strategy in which JPanels are drawn offscreen when 
they are updated and displayed only when complete. 


The primary surface is the visible screen surface during double buffering. 
The back buffer is the offscreen image during double buffering. 


A block line transfer, or blitting, is the act of copying the contents from one surface to 
another. 


A JScro11Pane provides scroll bars along the side or bottom of a pane, or both, so that the 
user can scroll initially invisible parts of the pane into view. 


The viewport is the viewable area in a JScro11Pane. 


An adapter class implements all the methods in an interface, providing an empty body for 
each method. 


The KeyListener interface contains methods that react to actions the user initiates from the 
keyboard. 


An action key is a keyboard key that does not generate a character. 
Virtual key codes represent keyboard keys that have been pressed. 
The x-axis is an imaginary horizontal line that indicates screen position. 


The y-axis is an imaginary vertical line that indicates screen position. 










The x-coordinate is a value that increases as you travel from left to right across a window. 
The y-coordinate is a value that increases as you travel from top to bottom across a window. 


The MouseMotionListener interface provides you with methods named mouseDragged() 
and mouseMoved() that detect the mouse being rolled or dragged across a component surface. 


The MouseListener interface provides you with methods named mousePressed(), 
mouseClicked(), and mouseReleased() that are analogous to the keyboard event methods 
keyPressed(), keyTyped(), and keyReleased(). 


The MouseInputListener interface implements all the methods in both the MouseListener 
and MouseMotionListener interfaces. 
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A MouseEvent is the type of event generated by mouse manipulation. 
Menus are lists of user options. 
A mnemonic is a key that causes an already visible menu item to be chosen. 


866 An accelerator is a key combination that causes a menu item to be chosen, whether or not 
the menu item is visible. 





A leaf menu item is a menu item that does not bring up another menu. 


Chapter Summary 


e Every top-level container has a content pane that contains all the visible components in 
the container’s user interface. The content pane can contain components and other 
containers. Whenever you create a top-level container, you can get a reference to its 
content pane using the getContentPane() method. 


e The Color class defines 13 colors for you to use in your applications. It can be used with 
the setBackground() and setForeground() methods of the Component class to make 
your applications more attractive and interesting. You also can create more than 16 
million custom colors. 


e The layout manager assigned to a Container determines how the components are sized 
and positioned within it. The BorderLayout manager is the default manager class for all 
content panes; when you use it, the components fill the screen in five regions: north, 
south, east, west, and center. The FlowLayout manager arranges components in rows 
across the width of a Container. When you create a GridLayout object, you indicate the 
numbers of rows and columns you want, and then the container surface is divided into a 
grid. The CardLayout manager generates a stack of containers or components, one on top 
of another. 


e A JPanel] is a plain, borderless surface that can hold lightweight UI components. 


e A JScro11Pane provides scroll bars along the side or bottom of a pane, or both, so that the 
user can scroll initially invisible parts of the pane into view. 












e ActionEvents are generated by components that users can click, such as JButtons and 
jCheckBoxes, and TextEvents are generated by components into which the user enters 
text, such as a JTextField. MouseEvents include determining the location of the mouse 
pointer and distinguishing between a single- and double-click. When you want to listen 
for an event, you implement an appropriate interface for your class. For every event class, 
such as <name>Event, there is a similarly named <name>Listener interface. Instead of 
implementing a listener class, you can extend an adapter class. 


e In addition to the handler methods included with the event listener interfaces, the 
AwWTEvent classes themselves contain methods that return information about an event. 
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e The MouseMotionListener interface provides you with methods named mouseDragged() 
and mouseMoved() that detect the mouse being rolled or dragged across a component 
surface. The MouseListener interface provides you with methods named 
mousePressed(), mouseClicked(), and mouseReleased(). The additional interface 
methods mouseEntered() and mouseExited() inform you when the user positions 
the mouse over a component (entered) or moves the mouse off a component (exited). 867 
The MouseInputListener interface implements all the methods in both the 
MouseListener and MouseMotionListener interfaces. 








e Menus are lists of user options. You use JMenuBar, JMenu, JMenuItem, and other classes in 
menu creation. 


Review Questions 
1. If you add fewer than five components to a BorderLayout, 


a. any empty component regions disappear 

b. the remaining components expand to fill the available space 
c. bothaandb 

d. none of the above 


2. When you resize a Container that uses BorderLayout, 

the Container and the regions both change in size 

the Container changes in size, but the regions retain their original sizes 
the Container retains its size, but the regions change or might disappear 


ao Ff PS 


nothing happens 


3. When you create a JFrame named myFrame, you can set its layout manager to 
BorderLayout with the statement 

myFrame.setLayout = new BorderLayout() ; 

myFrame.setLayout(new BorderLayout()); 


setLayout(myFrame = new BorderLayout()); 









a0 Ff SP 


setLayout (BorderLayout (myFrame) ) ; 


4, Which of the following is the correct syntax for adding a JButton named b1 to a 
Container named con when using CardLayout? 
a. con.add(b1); c. con.addC"Options", b1); 
b. con.add("b1"); d. none of the above 
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10. 


11. 


You can use the __________ class to arrange components in a single row or 
column of a container. 


a. FlowLayout c. CardLayout 

b. BorderLayout d. BoxLayout 

When you use ___, the components you add fill their region; they do not 
retain their default size. 

a. FlowLayout c. FixedLayout 

b. BorderLayout d. RegionLayout 

The statement ___________. ensures that components are placed from left to right 


across a JFrame surface until the first row is full, at which point a second row is 
started at the frame surface’s left edge. 

setLayout(FlowLayout.LEFT) ; 

setLayout(new FlowLayout(LEFT)) ; 

setLayout(new FlowLayout(FlowLayout.LEFT)) ; 


ao F PS 


setLayout (FlowLayout(FlowLayout.LEFT)) ; 


The GridBagLayout class allows you to 


a. add components to precise locations within the grid 

b. indicate that specific components should span multiple rows or columns 
within the grid 

c. bothaandb 
none of the above 


The statement setLayout(new GridLayout(2,7)); establishes a GridLayout 
with _____—————-—srhhorrizonttal row(s). 

a. zero c. two 

b. one d. seven 


As you add new components to a GridLayout, 


they are positioned from left to right across each row in sequence 
you can specify exact positions by skipping some positions 

both of the above 

none of the above 


ao Ff 


A JPanel isa 


a. Window c. both of the above 
b. Container d. none of the above 
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12. 


13. 


14. 


15. 


16. 


17. 


18. 


19. 


20. 
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The _________ class allows you to arrange components as if they are stacked 
like index or playing cards. 








a. GameLayout c. BoxLayout 
b. CardLayout d. GridBagLayout 
869 
AwTEvent is the child class of 
a. EventObject c. ComponentEvent 
b. Event d. ItemEvent 


When a user clicks a JPanel or JFrame, the action generates a(n) 
a. ActionEvent c. PanelEvent 

b. MouseEvent d. KeyboardEvent 
Event handlers are 

a. abstract classes c. listeners 

b. concrete classes d. methods 

The return type of getComponent() is 

a. Object c. int 

b. Component d. void 

The KeyEvent method getKeyChar() returns a(n) 

a. int c. KeyEvent 


b. char d. AWTEvent 


The MouseEvent method that allows you to identify double-clicks is 


a. getDouble() c. getDoubleClick() 
b. isClickDoubleQ d. getClickCountQ 
You can use the ______ method to determine the Object in which an 


ActionEvent originates. 








a. getObjectQ c. getOrigin() 
b. getEvent() d. getSource() 


Which of the following is true in a standard menu application? 


A JMenuItem holds a JMenu. 

A JMenuItem holds a JMenuBar. 
A JMenuBar holds a JMenu. 

A JMenu holds a JMenuBar. 
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Exercises 


Programming Exercises 


Create a JFrame, and set the layout to BorderLayout. Place a JButton in each 
region, and place the name of an appropriate United States landmark on each 
JButton. For example, New York’s Statue of Liberty might be the landmark in the 
east region. Save the file as JLandmarkFrame.java. 


Create an educational program for children that distinguishes between vowels and 
consonants as the user clicks buttons. Create 26 JButtons, each labeled with a 
different letter of the alphabet. Create a JFrame to hold three JPanels in a two- 
by-two grid. Randomly select eight of the 26 JButtons and place four in each of 
the first two JPanels. Add a JLabel to the third JPanel. When the user clicks 

a JButton, the text of the JLabel identifies the button’s letter as a vowel or 
consonant, and then a new randomly selected letter replaces the letter on the 
JButton. Save the file as JvWowelConsonant.java. 


Create a JFrame that holds five buttons with the names of five different fonts. 
Include a sixth button that the user can click to make a font larger or smaller. 
Display a demonstration JLabel using the font and size that the user selects. Save 
the file as JFontSelector.java. 


Create a JFrame that uses BorderLayout. Place a JButton in the center region. 
Each time the user clicks the JButton, change the background color in one of the 
other regions. Save the file as JColorFrame.java. 


Create a JFrame with JPanels, a JButton, and a JLabel. When the user clicks the 
JButton, reposition the JLabel to a new location in a different JPanel. Save the file 
as JMovingFrame.java. 


Create a class named JPanelOptions that extends JPanel and whose constructor 
accepts two colors and a String. Use the colors for background and foreground to 
display the String. Create an application named JTeamColors with GridLayout. 
Display four JPanelOptions JPanels that show the names, in their team colors, 
of four of your favorite sports teams. Save the files as JPanelOptions.java and 
JTeamColors.java. 


Write an application that lets you determine the integer value returned by the 
InputEvent method getModifiers() when you click your left, right, or—if you 
have one—middle mouse button on a JFrame. Save the file as JLeftOrRight.java. 
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8. a. Search the Java Web site for information on how to use a JTextArea. Write an 
application for the WebBuy Company that allows a user to compose the three 
parts of a complete e-mail message: the “To:”, “Subject:”, and “Message:” text. 
The “To:” and “Subject:” text areas should provide a single line for data entry. 
The “Message:” area should allow multiple lines of input and be able to scroll if 
necessary to accommodate a long message. The user clicks a button to send the 871 
e-mail message. When the message is complete and the Send button is clicked, 
the application should display “Mail has been sent!” on a new line in the message 
area. Save the file as JEMail.java. 








b. Modify the JEMai1 application to include a Clear button that the user can 


click at any time to clear the “To:”, “Subject:”, and “Message:” fields. Save the file 
as JEMail2.java. 


9. a. Create an application that uses a graphic interface to capture room assignment 
data for dormitory residents and writes that data to a random access output 
file. The data required for each assignment includes a room number from 
1 through 99 inclusive and the first and last names of the resident. Allow the 
user to enter data one record at a time and to click a button to save it. Save the 
class as CreateRandomDormFile.java. 


b. Create an application that allows the user to enter a room number and display 
the name of the stored resident for the room, if any. Save the file as 
ReadRandomDormfFile.java. 


10. Create a JFrame for the Summervale Resort. Allow the user to view information 
about different rooms available, dining options, and activities offered. Include at 
least two options in each menu, and display appropriate information when the user 
makes a choice. Save the file as SummervaleResort.java. 


& Debugging Exercises 


1. Each of the following files in the Chapter15 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and 
fix the program. After you correct the errors, save each file using the same 
filename preceded with Fix. For example, DebugFifteen1.java will become 
FixDebugFifteen1 java. 








a. DebugFifteenl.java c. DebugFifteen3 java 
b. DebugFifteen2.java d. DebugFifteen4.java 
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oO, Game Zone 


As you create some of the games in this section, you might find it convenient to add or remove 
components in a container after construction. Recall from Chapter 14 that in order for the user to see 
your changes, you might need to call the validate(), invalidate(), and repaint() methods. 
You will learn more about the repaint() method in the next chapter, Graphics. 
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1. a. Create a Mine Field game in which the user attempts to click 10 panels of a grid 
before hitting the “bomb.” Set up a JFrame using BorderLayout, use the NORTH 
region for a congratulatory message, and use the CENTER region for the game. In 
the CENTER region, create a four-by-five grid using GridLayout and populate the 
grid with JPanels. Set the background color for all the JPanels to Color. BLUE. 
Randomly choose one of the panels to be the bomb; the other 19 panels are 
“safe.” Allow the player to click on grids. If the player chooses a safe panel, turn 
the panel to Color.WHITE. If the player chooses the bomb panel, turn the panel to 
Color.RED and turn all the remaining panels white. If the user successfully 
chooses 10 safe panels before choosing the bomb, display a congratulatory 
message in the NORTH JFrame region. Save the game as MineField.java. 


b. Improve the Mine Field game by allowing the user to choose a difficulty level 

before beginning. Place three buttons labeled “Easy”, “Intermediate”, and 
“Difficult” in one region of the JFrame, and place the game grid and 

congratulatory message in other regions. Require the user to select a difficulty 
level before starting the game, and then disable the buttons. If the user chooses 
“Easy”, the user must select only five safe panels to win the game. If the user 
selects “Intermediate”, require 10 safe panels, as in the original game. If the user 
selects “Difficult”, require 15 safe panels. Save the game as MineField2.java. 


2. a. Create a game that helps new mouse users improve their hand-eye coordination. 
Within a JFrame, display an array of 48 JPanels in a GridLayout using eight rows 
and six columns. Randomly display an X on one of the panels. When the user 
clicks the correct panel (the one displaying the X), remove the X and display it on 
a different panel. After the user has successfully “hit” the correct panel 10 times, 
display a congratulatory message that includes the user’s percentage (hits divided 
by clicks). Save the file as JCatchTheMouse.java. 












b. Review how to use the GregorianCalendar class from Chapter 4, and then 
revise the JCatchTheMouse game to conclude by displaying the number of 
seconds it took the user to click all 10 Xs. When the application starts, create 
a GregorianCalendar object and use the get(Calendar.SECOND) and 
get(Calendar.MINUTE) methods with it to get the SECOND and MINUTE values 
at the start of the game. When the user has clicked all 10 Xs, create a second 
GregorianCalendar object and get the SECOND and MINUTE values at the end of 
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the game. If the user starts and ends a game during the same minute, then the 
playing time is simply the difference between the two SECOND values. Make sure 
your application times the game correctly even if the start and stop times do not 
occur during the same MINUTE. Save the file as JCatchTheMouseTimed.java. 


c. In the JCatchTheMouseTimed game described in Game Zone exercise 2b, the 
timer does not work correctly if the user happens to play when the hour, day, or 
year changes. Visit the Java Web site to find out how to use the 
GregorianCalendar class method getTimeInMillisQ, and then modify the 
game to measure playing time accurately, no matter when the user plays the 
game. Save the file as JCatchTheMouseTimed2.java. 
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If you were writing a professional timed game, you would test the timer’s accuracy regardless of when 
the user decided to play. For example, if the user played over the midnight hour on New Year's Eve, you 
would either have to test the game then (which is impractical), or reset your system’s clock to simulate 
New Year’s Eve. If you are writing the programs in this book on a school’s computer network, you might 
be blocked by the administrator from changing the date and time. Even if you are working on your own 
computer, do not attempt to change the date and time unless you understand the impact on other 
installed applications. For example, your operating system might assume that an installed virus-protection 
program is expired, or a financial program might indicate that automatically paid bills are overdue. 





3. The game Corner the King is played on a checkerboard. To begin, a checker is 
randomly placed in the bottom row. The player can move one or two squares to the 
left or upward, and then the computer can move one or two squares left or up. The 
first to reach the upper-left corner wins. Design a game in which the computer’s 
moves are chosen randomly. When the game ends, display a message that indicates 
the winner. Save the game as CornerTheKing java. 


4. Create a target practice game that allows the user to click moving targets and 
displays the number of hits in a 10-second period. Create a grid of at least 100 
jPanels. Randomly display an X on five panels to indicate targets. As the user clicks 
each X, change the label to indicate a hit. When all five Xs have been hit, randomly 
display a new set of five targets. Continue with as many sets as the user can hit in 10 
seconds. (Use www.oracle.com/technetwork/java/index.html to find how to use the 
GregorianCalendar class method getTimeInMillisQ© to calculate the time 
change.) When the time is up, display a count of the number of targets hit. Save the 
file as JTargetPractice.java. 













5. You set up the card game Concentration by placing pairs of cards face down in a 
grid. The player turns up two cards at a time, exposing their values. If the cards 
match, they are removed from the grid. If the cards do not match, they are turned 
back over so their values are hidden again, and the player selects two more cards to 
expose. Using the knowledge gained by the previously exposed cards, the player 
attempts to remove all the pairs of cards from play. Create a Java version of this 
game using a GridLayout that is four rows high and five columns wide. Randomly 
assign two of the numbers 0 through 9 to each of 20 JPanels, and place each of the 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce: iti 


CHAPTER 15 Advanced GUI Topics 


20 JPanels in a cell of the grid. Initially, show only “backs” of cards by setting each 

panel’s background to a solid color. When the user clicks a first card, change its 

color and expose its value. After the user clicks a second card, change its color to the 

same color as the first exposed card, expose the second card’s value, and keep both 

cards exposed until the user’s mouse pointer exits the second card. If the two 

874 exposed cards are different, hide the cards again. If the two turned cards match, 
then “remove” the pair from play by setting their background colors to white. When 
the user has matched all 20 cards into 10 pairs, display a congratulatory message. 
Save the game as JConcentration.java. 





6. Create a Mine Sweeper game by setting up a grid of rows and columns in which 
“bombs” are randomly hidden. You choose the size and difficulty of the game; for 
example, you might choose to create a fairly simple game by displaying a four-by- 
five grid that contains four bombs. If a player clicks a panel in the grid that contains 
a bomb, then the player loses the game. If the clicked panel is not a bomb, display a 
number that indicates how many adjacent panels contain a bomb. For example, if a 
user clicks a panel containing a 0, the user knows it is safe to click any panel above, 
below, beside, or diagonally adjacent to the cell, because those cells cannot possibly 
contain a bomb. If the player loses by clicking a bomb, display all the numeric values 
as well as the bomb positions. If the player succeeds in clicking all the panels except 
those containing bombs, the player wins and you should display a congratulatory 
message. Figure 15-44 shows the progression of a typical game. In the first screen, 
the user has clicked a panel, and the display indicates that two adjacent cells contain 
a bomb. In the second screen, the user has clicked a second panel, and the display 
indicates that three adjacent cells contain bombs. In the last screen, the user has 
clicked a bomb panel, and all the bomb positions are displayed. Save the game as 
MineSweeper.java. 
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Figure 15-44 Typical progression of MineSweeper game 


7. Create the game Lights Out using a BorderLayout. Place a five-by-five grid of panels 
in one region, and reserve another region for a congratulatory message. Randomly set 
each panel in the grid to a dark color or light color. The object of the game is to force 
all the panels to be dark, thus turning the “lights out.” When the player clicks a panel, 
turn all the panels in the same row and column, including the clicked panel, to the 
opposite color. For example, if the user clicks the panel in the second row, third 
column, then darken all the light-colored panels in the second row and third column, 
and lighten all the dark-colored panels in that row and column. When all the panels in 
the grid are dark, all the lights are out, so display a congratulatory message. Save the 
game as LightsOut.java. 
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CHAPTER 15 Advanced GUI Topics 


8. The game StopGate is played on a checkerboard with a set of dominoes; each domino 
is large enough to cover two checkerboard squares. One player places a domino 
horizontally on the checkerboard, covering any two squares. The other player then 
places a domino vertically to cover any other two squares. When a player has no more 
moves available, that player loses. Create a computerized version of the game in which 

876 the player places the horizontal pieces and the computer randomly selects a position 

for the vertical pieces. (Game construction will be simpler if you allow the player to 
select only the left square of a two-square area and assume that the domino covers 
that position plus the position immediately to the right.) Use a different color for the 
player’s dominoes and the computer’s dominoes. Display a message naming the 
winner when no more moves are possible. Figure 15-45 shows a typical game after the 
player (blue) and computer (black) have each made one move, and near the end of the 
game when the player is about to win—the player has two moves remaining, but the 
computer has none. Save the file as StopGate.java. 








| S| Stop Gate Sree) | S| Stop Gate So) 
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Figure 15-45 A typical game of StopGate just after play begins and near the end of the game 
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Q Case Problems 


In Chapter 14, you created an interactive GUI application for Carly’s Catering that 
allows the user to enter a number of guests for an event and to choose an entrée, two 
side dishes, and a dessert from groups of choices. Then, the application displays the 877 
cost of the event and a list of the chosen items. Now, modify the interface to include 

separate panels for the guest number entry, each group of menu choices, and the 

output. Use at least two different layout managers and at least two different colors in 

your application. Save the program as JCarlysCatering.java. 








2. In Chapter 14, you created an interactive GUI application for Sammy’s Seashore 
Rentals that allows the user to enter a rental time in hours, an equipment type, 
and a lesson option. Then, the application displays the cost of the rental and 
rental details. Now, modify the interface to include separate panels for the hour 
entry, each group of menu choices, and the output. Use at least two different 
layout managers and at least two different colors in your application. Save the 
program as JSammysSeashore.java. 
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Graphics 


In this chapter, you will: 


Learn about the paint() and repaint() methods 


Use the drawString() method to draw Strings using 
various fonts and colors 


Draw lines and shapes 
Learn more about fonts 


Draw with Java 2D graphics 





Unless noted otherwise, all images are © 2014 Cengage Learning 
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CHAPTER 16 Graphics 


Learning About the paint() and repaint() Methods 


When you run a Java program that contains graphics, such as the JFrame applications in 
the previous chapters, the display surface frequently must be redisplayed, or rerendered. 
Redisplaying a surface also is called painting. Painting operations fall into two broad 

880 categories based on what causes them: 





e System-triggered painting operations occur when the system asks a component to render 
its contents. This happens when the component is first made visible, if it is resized, or if 
it is damaged. For example, a component becomes damaged when another component 
that previously covered part of it has been moved, revealing a portion that was not visible. 


e Application-triggered painting operations occur when the internal state of a component 
has changed. For example, when a user clicks a button, a “pressed” version of the button 
must be rendered. 


Whether a paint request is triggered by the system or by an application, a Component’s 
paintQ© method is invoked. The header for the paint() method is: 


public void paint(Graphics g) 


The parameter to the method is a Graphics object. The Graphics class is an abstract 
class that descends directly from Object and holds data about graphics operations and 
methods for drawing shapes, text, and images. When AWT invokes the paint() method, 
the Graphics object parameter is preconfigured with the appropriate values for drawing 
on the component: 


e The Graphics object’s color is set to the component’s foreground property. 
e The Graphics object’s font is set to the component’s font property. 


e The Graphics object’s translation is set such that the coordinates 0, 0 represent the 
upper-left corner of the component. 


e The Graphics object’s clip rectangle is set to the area of the component that needs 
repainting. 


Programs must use this Graphics object (or one derived from it) to render graphic output. 
They can change the values of the Graphics object as necessary. 


You override the paint() method in your programs when you want specific actions to take 
place when components must be rendered. You don’t usually call the paint() method 
directly. Instead, you call the repaint () method, which you can use when a window needs to 
be updated, such as when it contains new images or you have moved a new object onto the 
screen. The Java system calls the repaint() method when it needs to update a window, or 
you can call it yourself—in either case, repaint( creates a Graphics object for you that 
becomes the paint() method parameter. The repaint() method calls another method 
named update(), which clears its Component’s content pane and calls the paint() method. 
The series of events is best described with an example. Figure 16-1 shows a JDemoPaint class 
that extends JFrame. The frame contains a JButton. The constructor sets a title, layout 
manager, and default close operation, and it adds the button to the frame. The button is 
designated as a source for actions to which the frame can respond. 
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Learning About the paint() and repaint() Methods D0 


import javax.swing.*; 

import java.awt.*; 

import java.awt.event.*; 

public class JDemoPaint extends JFrame implements ActionListener 

{ 881 
JButton pressButton = new JButton("Press"); 
public JDemoPaint() 
{ 








setTitleC"Paint Demo"); 

setLayout(new FlowLayout()); 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
add(pressButton) ; 
pressButton.addActionListener (this) ; 


public void actionPerformed(ActionEvent e) 


{ 
System.out.printC("Button pressed. "); 


repaint(); 


public void paint(Graphics g) 
{ 


super.paint(g); 
System.out.printInC"In paint method."); 


} 

public static void main(String[] args) 

{ 
JDemoPaint frame = new JDemoPaint(); 
frame.setSize(150, 100); 
frame.setVisible(true) ; 





Figure 16-1 The JDemoPaint class 


is a call to the paint () method that is part of JDemoPaint’s parent class (JFrame), and it passes the 
local Graphics object (named g) to this method. Although this program and others in this chapter will work 
without this statement, omitting it causes errors in more complicated applications. For now, get in the habit 
of including this method call as the first statement in any JFrame’s paint () method, using whatever local 
name you have declared for your paint() method’s Graphics argument. 


Q In Figure 16-1, the shaded first line of code in the paint) method is super. paint (g) ;. This statement 


In the JDemoPaint class in Figure 16-1, the actionPerformed() method executes when the 
user presses the JButton. The method contains a call to repaint(), which is unseen in the 
class and which automatically calls the paint© method. 


The paint() method in the JDemoPaint class overrides the automatically supplied paintQ 
method. The paint() method displays a line of output at the command line—it announces 
that the paint© method is executing. Figure 16-2 shows a typical execution of the program. 
The JFrame is first drawn when it is constructed, and the message “In paint method.” appears 
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CHAPTER 16 Graphics 


at the command line. When the user clicks the button on the frame, two messages are 
displayed: “Button pressed.” from the actionPerformed() method, and “In paint method.” 
from the paint() method that is called by repaint(). When the user minimizes and 
restores the frame, paint is called automatically, and the “In paint method.” message is 
displayed again. 

882 








r 
xe Command Prompt ae aoe 


C:\Java>java JDemoPaint 
In paint method. 
Button pressed. In paint method. 


In paint method. 


C:\Java> 











Figure 16-2 Typical execution of the JDemoPaint program 


If you call repaint( alone in a class that is a container, then the entire container is repainted. 
(The call to repaint) in Figure 16-1 is actually this. repaintQ ;.) Repainting the entire 
container might be unnecessary and waste time if only part of the container has changed. 
If you call repaint(© with a component, as in pressButton. repaint(), then only that 
component is repainted. 


~The repaint method only requests that Java repaint the screen. If a second request to repaint () 
Y occurs before Java can carry out the first request, Java executes only the last repaint) method. 


Then the paint() method redraws the contents. The effect is that components are “erased” before 


, Before the builtin paint) method is called, the entire container is filled with its background color. 
Y being redrawn. 


Using the setLocation() Method 


The setLocation() method allows you to place a component at a specific location within 
a JFrame’s content pane. In Chapter 15, you learned that a window or frame consists of a 
number of pixels on the screen, and that any component you place on the screen has a 
horizontal, or x-axis, position as well as a vertical, or y-axis, position. The horizontal 
position number increases from left to right across the screen, and the vertical position 
number increases from top to bottom. 


When you allow a layout manager to position components, specific positions are selected 
automatically for each component. You can change the position of a component by using the 
setLocation() method and passing it x- and y-coordinate positions. For example, to position 
a JLabel object named someLabe] at the upper-left corner of a JFrame, you write the 
following within the JFrame class: 


someLabel.setLocation(O, 0); 
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Learning About the paint() and repaint( Methods D0 


If a window is 200 pixels wide by 100 pixels tall, you can place a Button named pressMe in the 
approximate center of the window with the following statement: 


pressMe.setLocation(100, 50); 


The coordinate arguments can be numeric constants or variables. 883 








When you use setLocation(), the upper-left corner of the component is placed at the 
specified x- and y-coordinates. In other words, if a window is 100 by 100 pixels, 
aButton.setLocation(100,100); places the JButton outside the window, where you 
cannot see the component. 


Figure 16-3 shows a JDemoLocation class that uses a call to the setLocation() method in the 
actionPerformed() method. The values of the x- and y-coordinates passed to setLocation() 
are initialized to 0, and then each is increased by 30 every time the user clicks the JButton. 
The JButton moves 30 pixels down and to the right every time it is clicked. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
public class JDemoLocation extends JFrame implements ActionListener 
{ 
JButton pressButton = new JButton("Press"); 
int x =0, y=0; 
final int GAP = 30; 
public JDemoLocation() 
{ 
setTitleC"Location Demo") ; 
setLayout(new FlowLayout()); 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
add(pressButton) ; 
pressButton.addActionListener (this) ; 
} 
public void actionPerformed(ActionEvent e) 


{ 


pressButton.setLocation(x, y); 
x += GAP; 
y += GAP; 


} 

public static void main(String[] args) 

{ 
JDemoLocation frame = new JDemoLocation(); 
frame.setSize(150, 150); 
frame.setVisible(true) ; 





Figure 16-3 The JDemoLocation class 
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CHAPTER 16 Graphics 


Figure 16-4 shows the JFrame in four positions: when it starts with the JButton in its 
default position; after the user clicks the JButton once, moving it to position 0, 0; after the 
user clicks it a second time, moving it to position 30, 30; and after the user clicks it a third 
time, moving it to position 60, 60. If the user continues to click the JButton, it moves off 
the frame surface. You could add a decision to prevent continued progression of the 

884 setLocation() coordinates. 











Figure 16-4 Execution of the JDemoLocation program 


The setLocation() method works correctly only when it is used after the layout manager 
has finished positioning all the application’s components (or in cases where no layout 
manager is functioning). If you try to use setLocation() on a component within its 
container’s constructor, the component will not be repositioned because the layout 
manager will not be finished placing components. 


Creating Graphics Objects 


When you call the paint() method from an application, you can use the automatically 
created Graphics object that is passed to it, but you can also instantiate your own Graphics 
objects. For example, you might want to use a Graphics object when some action occurs, 
such as a mouse event. Because the actionPerformed() method does not supply you with a 
Graphics object automatically, you can create your own. 


To display a string when the user clicks a JButton, you can code an actionPerformed() 
method such as the following: 


public void actionPerformed(ActionEvent e) 


{ 
Graphics draw = getGraphics(); 
draw.drawString("You clicked the button!", 50, 100); 


} 


This method instantiates a Graphics object named draw. (You can use any legal Java 
identifier.) The getGraphics() method provides the draw object with Graphics capabilities. 
Then the draw object can employ Graphics methods such as setFont(), setColor(), and 
drawString(). 


Notice that when you create the draw object, you are not calling the Graphics constructor 
directly. (The name of the Graphics constructor is Graphics(Q, not getGraphics().) 
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Using the drawString© Method 


This operation is similar to the way you call getContentPane(). You are not allowed to call 
the Graphics or ContentPane constructors because those classes are abstract classes. 


If you call getGraphics() ina frame that is not visible, you receive a Nul1PointerException, and 
GY the program will not execute. 


885 








ee 
Cau Watch the video Using paintQ and repaintQ. 


Learning About the paint() and repaint() Methods 


1. Painting can be system triggered (for example, when a component is resized) or 
application triggered (for example, when a user clicks a button). 


2. When the paintQ method is called, the Graphics object parameter is 
preconfigured with the appropriate state for drawing on the component, 
including the color and font. 


3. You override the repaint() method in your programs when you want specific 
actions to take place when components must be rendered. You usually call the 
paint() method directly, and it calls repaintQ. 
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Using the drawString() Method 


The drawString(® method allows you to draw a String in a JFrame or other component. The 
drawString() method requires three arguments: a String, an x-axis coordinate, and a y-axis 
coordinate. 


You are already familiar with x- and y-axis coordinates because you used them with the 
setLocation() method for components. However, there is a minor difference in how you 
place components using the setLocation() method and how you place Strings using the 
drawString() method. When you use x- and y-coordinates with components, such as 
JButtons or JLabels, the upper-left corner of the component is placed at the coordinate 
position. When you use x- and y-coordinates with drawString(), the lower-left corner of the 
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886 





String appears at the coordinates. Figure 16-5 shows the positions of a JLabel placed at the 
coordinates 30, 10 and a String placed at the coordinates 10, 30. 


X 





jo 10. 20 30 40 50 60 





Figure 16-5 Placement of String and JLabel objects on a frame 


The drawString() method is a member of the Graphics class, so you need to use a Graphics 
object to call it. Recall that the paint() method header shows that the method receives a 
Graphics object from the update() method. If you use drawString() within paintQ, 

the Graphics object you name in the header is available to you. For example, if you write a 
paint() method with the header public void paint(Graphics brush), you can draw a 
String within your paint() method by using a statement such as: 


brush.drawStringC("Hi", 50, 80); 


Interestingly, when you use the drawString() method with a negative font size, the string 
appears upside down. The coordinates then indicate the lower-right corner of the string. 


Using the setFont( and setColor() Methods 


You can improve the appearance of strings drawn using Graphics objects by using the 
setFont() method. The setFont() method requires a Font object, which, as you may recall 
from Chapter 14, you can create with a statement such as: 


Font someFont = new Font("Arial", Font.BOLD, 16); 


Then you can instruct a Graphics object to use the font by inserting the font as the argument 
in a setFont() method. For example, if a Graphics object is named artist and a Font object 
is named smal1Font, the font is set to smal1Font with the following: 


artist.setFont(smal1Font) ; 


Figure 16-6 shows an application that uses the setFont() method with a Graphics object 
named brush. 
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Using the drawString© Method 


import javax.swing.*; 
import java.awt.*; 
public class JDemoFont extends JFrame 
{ 
Font bigFont = new Font("Serif", Font.ITALIC, 48); 887 
String hello = "Hello"; 
public void paint(Graphics brush) 
{ 








super.paint (brush) ; 


brush. setFont(bigFont) ; 
brush.drawString(hello, 10, 100); 
} 
public static void main(String[] args) 
{ 
JDemoFont frame = new JDemoFont(); 
frame.setSize(180, 150); 
frame.setVisible(true) ; 





Figure 16-6 The JDemoFont class 


When the paint() method executes in the JDemoFont example, bigFont is assigned to the 
automatically created brush object. Then the brush object is used to draw the he11o string at 
position 10, 100. Figure 16-7 shows the output. 





Figure 16-7 Output of the JDemoFont program 


Using Color 


You can designate a Graphics color with the setColor() method. As you learned in Chapter 
15, the Color class contains 13 constants; you can use any of these constants as an argument 
to the setColor© method. For example, you can instruct a Graphics object named brush to 
apply green paint by using the following statement: 


brush.setColor(Color.GREEN) ; 
Until you change the color, subsequent graphics output appears as green. 
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Using the drawString() Method 


888 1. The drawStringQ method requires three arguments: a String, an x-axis 
coordinate, and a y-axis coordinate. 





2. When you use x- and y-coordinates with components such as JButtons or 
JLabels, the lower-left corner of the component is placed at the coordinate 
position, but when you use x- and y-coordinates with drawStringQ, the upper- 
left corner of the String appears at the coordinates. 


3. The drawString® method is a member of the Graphics class, so you need to 
use a Graphics object to call it. 
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“ns You Do It 


Using the drawStringQ© Method 


In the next steps, you write a class that extends JFrame and uses the drawStringQ 
method. 


1. Openanew text file, and begin a class definition for a JDemoGraphics Class by 
typing the following: 


import javax.swing.*; 
import java.awt.*; 
public class JDemoGraphics extends JFrame 


{ 
2. Declare a String by typing the following: 

String movieQuote = new String("You talkin’ to me?"); 
3. Adda constructor to set the default close operation: 


publ ic JDemoGraphics() 
{ 


} 


setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
(continues) 
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Using the drawString© Method 


(continued) 


4. Type the following paint(© method that calls the super(@ method and uses a 
Graphics object to draw the movieQuote String. 


public void paint(Graphics gr) 889 


{ 








super ..paint (gr) ; 
gr.drawString(movieQuote, 30, 100); 
} 


5. AddamainQ method that instantiates a JDemoGraphics object and sets its size 
and visibility. Then add the closing curly brace for the class: 


public static void main(StringL[] args) 


{ 
JDemoGraphics frame = new JDemoGraphicsQ) ; 
frame.setSize(280, 200); 
frame.setVisible(true) ; 

} 


} 


6. Save the file as JDemoGraphics.java, and then compile and execute it. The 
program’s output appears in Figure 16-8. 





You talkin'to me? 





Figure 16-8 Output of the JDemoGraphics program 


7. Close the JFrame to end the application. 


Using Fonts and Colors 


Next, you use your knowledge of fonts and colors to set the color and font style of a 
drawn String. 


(continues) 
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(continued) 


1. Open the JDemoGraphics.java text file in your text editor, and immediately 
save it as JDemoGraphics2.java. Change the class name, the constructor 
890 name, and the two references in the main® method to match. 





2. Add anew import statement to the current list so that the application can 
use color: 


import java.awt.Color; 


3. Just after the movieQuote declaration, add a Font object by typing 
the following: 


Font bigFont = new Font("Boopee", Font. ITALIC, 30); 


4. Within the paint© method after the call to super, type the following 
statements so the gr object uses the bigFont object and the color magenta: 


gr.setFont(bigFont) ; 
gr.setColor(Color.MAGENTA) ; 


5. Following the existing drawString() method call, type the following lines to 
change the color and add another call to the drawString( method: 


gr.setColor(Color.BLUE) ; 
gr.drawString(movieQuote, 60, 140); 


6. Save the file, compile it, and execute it. The program's output appears in 
Figure 16-9. Although the figure is shown in black and white in this book, 
notice that the Strings on your screen are displayed as magenta and blue 
text. The font that appears in your program might be different from the one 
shown in the figure, depending on your computer's installed fonts. (Later in 
this chapter, you will learn how to view a list of all the available fonts on your 
computer.) 


You talkin to mee 


You talkin’ to me? 








Figure 16-9 Output of the JDemoGraphics2 program 
(continues) 
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(continued) 


7. Close the JFrame to end the application. 
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Creating Your Own Graphics Object 


Next, you create a Graphics object named pen and use the object to draw a 
String on the screen. The text of the String will appear to move each time a 
JButton is clicked. 


1. Open anew text file in your text editor, and type the following import statements 
for the program: 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
import java.awt.Color; 


2. Start typing the following class that extends JFrame and uses the mouse. The 
class defines a String, a JButton, a Font, and four integers: two to hold x- and y- 
coordinates, one to act as a constant size to measure the gap between lines 
displayed on the screen, and one to hold the size of the JFrame: 


public class JDemoCreateGraphicsObject extends JFrame 
implements ActionListener 

{ 
String movieQuote = new String("Here’s looking at you, kid"); 
JButton moveButton = new JButton("Move It"); 
Font broadwayFont = new Font("Broadway", Font.ITALIC, 12); 
intx=10, y=50; 
final int GAP = 20; 
final int SIZE = 400; 


3. Type the following constructor; it changes the background color and sets the 
layout of the Container, adds the JButton, prepares the JFrame to listen for 
jButton events, sets the close operation, and sets the size of the frame: 


public JDemoCreateGraphicsObject() 

{ 
Container con = getContentPane() ; 
con. setBackground(Color. YELLOW) ; 
con.setLayout (new FlowLayout() ); 
con.add(moveButton) ; 
moveButton.addActionListener(this) ; 
setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE); 
setSize(SIZE, SIZE); 


(continues) 
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(continued) 


4. Within the actionPerformed() method, you can create a Graphics object 
and use it to draw the String on the screen. Each time a user clicks the 
892 JButton, the x- and y-coordinates both increase, so a copy of the movie 
quote appears slightly below and to the right of the previous one. Type the 
following actionPerformed() method to accomplish this processing: 





public void actionPerformed(ActionEvent e) 
{ 
Graphics pen = getGraphicsQ ; 
pen. setFont (broadwayFont) ; 
pen.setColor(Color.MAGENTA) ; 
pen.drawString(movieQuote, x += GAP, y += GAP); 
} 


5. Adda mainQ method to instantiate a JDemoCreateGraphicsObject object 
and give it visibility. Add a closing curly brace for the class. 


public static void main(String[] args) 
{ 
JDemoCreateGraphicsObject frame = new 
JDemoCreateGraphicsObjectQ ; 
frame.setVisible(true) ; 


} 


6. Save the file as JDemoCreateGraphicsObject.java, and then compile and 
run the program. Click the Move It button several times to see the String 
message appear and move on the screen. 


7. When you finish clicking the button, close the JFrame to end the application. 


Examining Screen Coordinates 


If you run JDemoCreateGraphicsObject and click the JButton enough times, the 
movie quote String appears to march off the bottom of the JFrame. Every time you 
click the JButton, the x and y-coordinates used by drawString( increase, and 
there is no limit to their value. You can prevent this error by checking the screen 
coordinates’ values to see if they exceed the JFrame’s dimensions. 


1. Open the JDemoCreateGraphicsObject file, and immediately save it as 
JDemoCreateGraphicsObject2. Change the class name, constructor name, 
and the two references to the class in the main@ method to match. 


(continues) 
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(continued) 


2. Because the screen size is 400 by 400, you can ensure that at least part of 
the String appears in the frame by preventing the y-coordinate from 
exceeding a value that is slightly less than 400. Create a constant to hold 893 
this limit by adding the following just after the declaration of SIZE: 








final int LIMIT = SIZE - 50; 


3. Inthe actionPerformed() method, replace the stand-alone call to drawStringO 
with one that depends on LIMIT as follows: 


if(y < LIMIT) 
pen.drawString(movieQuote, x += GAP, y += GAP); 


4. Add an else clause that disables the JButton after the x coordinate becomes 
too large: 


else 
moveButton. setEnabled(false) ; 


5. Save the file, compile it, and execute it. Now when you click the Move It button, 
the movie quote moves until the y-coordinate reaches 350. At that point, the 
JButton is disabled, and the movie quote no longer violates the frame’s size 
limits. 


6. Close the frame to end the program. 


Drawing Lines and Shapes 


Just as you can draw Strings using a Graphics object and the drawString() method, Java 
provides you with several methods for drawing a variety of lines and geometric shapes. Any 
line or shape is drawn in the current color you set with the setColor() method. When you 
do not set a color, lines are drawn in black by default. 


~_ [tis almost impossible to draw a picture of any complexity without sketching it first on a piece of graph paper 
Y to help you determine correct coordinates. 
( 


Drawing Lines 


You can use the drawLine() method to draw a straight line between any two points on the 
screen. The drawLine() method takes four arguments: the x- and y-coordinates of the line’s 
starting point and the x- and y-coordinates of the line’s ending point. For example, if you create 
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a Graphics object named pen, then the following statement draws a straight line that slants 
down and to the right, from position 50, 50 to position 100, 200, as shown in Figure 16-10. 


pen.drawLine(50, 50, 100, 200); 


Because you can start at either end when you draw a line, an identical line is created with 
894 the following: 





pen.drawLine(100, 200, 50, 50); 





Figure 16-10 A line created with pen.drawLine(50, 50, 100, 200) 


Your downloadable student files contain a JDemoLine.java file with a working program that draws the line 
GY shown in Figure 16-10. 


Drawing Rectangles 


You could draw a rectangle by drawing four lines. Alternatively, you can use the drawRect() 
method and fi11Rect( method, respectively, to draw the outline of a rectangle or to draw a 
solid, or filled, rectangle. Each of these methods requires four arguments. The first two 
arguments represent the x- and y-coordinates of the upper-left corner of the rectangle. 

The last two arguments represent the width and height of the rectangle. For example, the 
following statement draws a short, wide rectangle that begins at position 20, 100, and is 200 
pixels wide by 10 pixels tall: 


drawRect(20, 100, 200, 10); 


The clearRect() method also requires four arguments and draws a rectangle. The difference 
between using the drawRect() and fil1Rect() methods and the clearRect() method is that 
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the first two methods use the current drawing color, whereas the clearRect() method draws 
what appears to be an empty or “clear” rectangle. A rectangle created with the clearRect() 
method is not really “clear”; in other words, it is not transparent. When you create a rectangle, 
you do not see objects that might be hidden behind it. Instead, the clearRect() method 


clears anything drawn from view, showing the original content pane. 
895 








For example, the constructor in the JDemoRectangles program shown in Figure 16-11 sets 
the background color of the content pane to blue and sets the layout manager. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.Color; 
public class JDemoRectangles extends JFrame 
{ 
Container con = getContentPane() ; 
public JDemoRectangles() 


.setBackground(Color.BLUE) ; 
.setLayout (new FlowLayout()); 


public void paint(Graphics gr) 

{ 
super.paint(gr); 
gr.setColor(Color.RED) ; 
gr.fillRect(40, 40, 120, 120); 
gr.setColor(Color. YELLOW) ; 
gr.fillRect(80, 80, 160, 160); 
gr.clearRect(50, 60, 50, 50); 

} 

public static void main(String[] args) 


4 


JDemoRectangles frame = new JDemoRectangles(); 
frame.setSize(200, 200); 
frame.setVisible(true) ; 





Figure 16-11 The JDemoRectangles class 


In the paint© method in Figure 16-11, the drawing color is set to red, and a filled rectangle 
is drawn. Then the drawing color is changed to yellow and a second filled rectangle is 
drawn to overlap the first. Finally, a smaller, “clear” rectangle is drawn that overlaps the 
other rectangles. As Figure 16-12 shows, you cannot see the boundaries of the original 
rectangles in the “clear” area—you simply see that portions of the filled rectangles have 
been removed from the drawing. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 16 Graphics 





896 











Figure 16-12 Output of the JDemoRectangles program 


You can create rectangles with rounded corners when you use the drawRoundRect () method. 
The drawRoundRect() method requires six arguments. The first four arguments match the 
four arguments required to draw a rectangle: the x- and y-coordinates of the upper-left 
corner, the width, and the height. The two additional arguments represent the arc width and 
height associated with the rounded corners (an arc is a portion of a circle). If you assign zeros 
to the arc coordinates, the rectangle is not rounded; instead, the corners are square. At the 
other extreme, if you assign values to the arc coordinates that are at least the width and height 
of the rectangle, the rectangle is so rounded that it is a circle. The paintQ method in Figure 
16-13 draws four rectangles with increasingly large corner arcs. The first rectangle is drawn at 
coordinates 20, 40, and the horizontal coordinate is increased by 100 for each subsequent 
rectangle. Each rectangle is the same width and height, but each set of arc values becomes 
larger, producing rectangles that are not rounded, slightly rounded, very rounded, and 
completely rounded in sequence. Figure 16-14 shows the program’s output. 


import javax.swing.*; 
import java.awt.*; 
public class JDemoRoundRectangles extends JFrame 
{ 
public void paint(Graphics gr) 
{ 
super.paint(gr); 
int x = 20; 
int y = 40; 
final int WIDTH = 80, HEIGHT = 80; 
final int HORIZONTAL_GAP = 100; 
for(int arcSize = x; arcSize <= HEIGHT; arcSize += 20) 


{ 


gr.drawRoundRect(x, y, WIDTH, HEIGHT, arcSize, arcSize); 
x += HORIZONTAL_GAP; 





Figure 16-13 The JDemoRoundRectang|les class (continues) 
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(continued) 


public static void main(String[] args) 


1 


JDemoRoundRectangles frame = new JDemoRoundRectangles() ; 
frame.setSize(420, 140); 897 
frame.setVisible(true) ; 








Figure 16-14 Output of the JDemoRoundRectangles program 


Java also contains a fi11RoundRect() method that creates a filled rounded rectangle and a 
clearRoundRect() method that creates a clear rounded rectangle. 


Creating Shadowed Rectangles 


The draw3DRect() method is a minor variation on the drawRect() method. You use the 
draw3DRect() method to draw a rectangle that appears to have “shadowing” on two of its 
edges—the effect is that of a rectangle that is lit from the upper-left corner and slightly raised 
or slightly lowered. The draw3DRect() method requires a fifth argument in addition to the x- 
and y-coordinates and width and height required by the drawRect() method. The fifth 
argument is a Boolean value, which is true if you want the raised rectangle effect (darker on 
the right and bottom) and false if you want the lowered rectangle effect (lighter on the right 
and bottom). There is also a £i113DRect() method for creating filled three-dimensional (3D) 
rectangles; this method is used in the program in Figure 16-15. 
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import javax.swing.*; 
import java.awt.*; 
import java.awt.Color; 
public class JDemo3DRectangles extends JFrame 
{ 
public void paint(Graphics gr) 
{ 


super.paint(gr); 
final int WIDTH = 60, HEIGHT = 80; 
gr.setColor(Color. PINK) ; 


gr.fi113DRect(20, 40, WIDTH, HEIGHT, true); 
gr.fi113DRect(100, 40, WIDTH, HEIGHT, false); 

} 

public static void main(String[] args) 

{ 
JDemo3DRectangles frame = new JDemo3DRectangles(); 
frame.setSize(180, 150); 
frame.setVisible(true) ; 





Figure 16-15 The JDemo3DRectangles class 


The program in Figure 16-15 creates two filled 3D rectangles in pink. (The 3D methods work 
best with lighter drawing colors.) You can see that the shadowing effect on the output in 
Figure 16-16 is very subtle; the shadowing is only one pixel wide. 





Figure 16-16 Output of the JDemo3DRectangles program 


Drawing Ovals 


You can draw an oval using the drawRoundRect() or fil1RoundRect() method, but it is 
usually easier to use the drawOval() and fi110va1() methods. The draw0val() and 
fi1110valQ methods both draw ovals using the same four arguments that rectangles use. 
When you supply draw0valQ or f1110val() with x- and y-coordinates for the upper-left 
corner and width and height measurements, you can picture an imaginary rectangle that uses 
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the four arguments. The oval is then placed within the rectangle so it touches the rectangle 
at the center of each of the rectangle’s sides. For example, suppose that you create a Graphics 
object named tool and draw a rectangle with the following statement: 


tool.drawRect(50, 50, 100, 60); 


Suppose that then you create an oval with the same coordinates as follows: 899 








tool.draw0val(50, 50, 100, 60); 


The output appears as shown in Figure 16-17, with the oval edges just skimming the 
rectangle’s sides. 





Figure 16-17 Demonstration of the drawOval() method 


Q Your downloadable student files contain a JDemoOval.java file that produces the frame in Figure 16-17. 


If you draw a rectangle with identical height and width, you draw a square. If you draw an oval 
with identical height and width, you draw a circle. 


Drawing Arcs 


In Java, you can draw an arc using the Graphics drawArc() method. To use the drawArc() 
method, you provide six arguments: 


e The x- and y-coordinates of the upper-left corner of an imaginary rectangle that 
represents the bounds of the imaginary circle that contains the arc 


e The width and height of the imaginary rectangle that represents the bounds of the 
imaginary circle that contains the arc 


e The beginning arc position and the arc angle 


Arc positions and angles are measured in degrees; there are 360 degrees in a circle. The 0° 
position for any arc is the three o’clock position, as shown in Figure 16-18. The other 359 
degree positions increase as you move counterclockwise around an imaginary circle, so 90° 
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is at the top of the circle in the 12 o’clock position, 180° is opposite the starting position at 
nine o'clock, and 270° is at the bottom of the circle in the six o’clock position. 





90 degrees 
900 





180 degrees O degrees 


270 degrees 





Figure 16-18 Arc positions 


The arc angle is the number of degrees over which you want to draw the arc, traveling 
counterclockwise from the starting position. For example, you can draw a half circle by 
indicating an arc angle of 180° or a quarter circle by indicating an arc angle of 90°. If you want 
to travel clockwise from the starting position, you express the degrees as a negative number. 
Just as when you draw a line, when drawing any arc you can take one of two approaches: 
either start at point A and travel to point B, or start at point B and travel to point A. For 
example, to create an arc object using a Graphics object named g that looks like the top half 
of a circle, the following statements produce identical results: 


g-drawArc(x, y, w, h, 0, 180); 
g-drawArc(x, y, w, h, 180, -180); 


The first statement starts an arc at the three o’clock position and travels 180 degrees 
counterclockwise to the nine o’clock position. The second statement starts at nine o’clock and 
travels clockwise to three o’clock. 


The fil1ArcQ method creates a solid arc. The arc is drawn, and two straight lines are drawn 
from the arc endpoints to the center of the imaginary circle whose perimeter the arc occupies. 
For example, assuming you have declared a Graphics object named g, the following two 
statements together produce the output shown in Figure 16-19: 


g.fillArc(20, 50, 100, 100, 20, 320); 
g.fillArc(60, 50, 100, 100, 340, 40); 
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Each of the two arcs is in a circle that has a size of 100 by 100. The first arc almost completes a 
full circle, starting at position 20 (near two o’clock) and ending 320 degrees around the circle 
(at position 340, near four o’clock). The second filled arc more closely resembles a pie slice, 
starting at position 340 and extending 40 degrees to end at position 20. 
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Figure 16-19 Two filled arcs 


Q Your downloadable student files contain a program named JDemoFillArc.java that produces Figure 16-19. 


Creating Polygons 


When you want to create a shape that is more complex than a rectangle, you can use a 
sequence of calls to the drawLine() method, or you can use the drawPolygon() method to 
draw complex shapes. The drawPolygon() method requires three arguments: two integer 
arrays and a single integer. 


The first integer array holds a series of x-coordinate positions, and the second array holds a 
series of corresponding y-coordinate positions. These positions represent points that are 
connected to form the polygon. The third integer argument is the number of pairs of points 
you want to connect. If you don’t want to connect all the points represented by the array 
values, you can assign this third argument integer a value that is smaller than the number of 
elements in each array. However, an error occurs if the third argument is a value higher than 
the available number of coordinate pairs. 


For example, examine the code shown in Figure 16-20, which is a JFrame application that has 
one task: to draw a star-shaped polygon. 
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import javax.swing.*; 

import java.awt.*; 

public class JStar extends JFrame 
{ 

902 public void paint(Graphics gr) 
{ 





super.paint(gr); 
int xPoints[] = {42, 52, 72, 52, 60, 40, 15, 28, 9, 32, 42}; 
int yPoints[] = {38, 62, 68, 80, 105, 85, 102, 75, 58, 60, 38}; 


gr.drawPolygon(xPoints, yPoints, xPoints. length) ; 
} 
public static void main(String[] args) 
{ 

JStar frame = new JStar(); 

frame.setSize(80, 150); 

frame.setVisible(true) ; 





Figure 16-20 The JStar class 


In the JStar program, two parallel arrays are assigned x- and y-coordinates. It is almost 
impossible to create a program like this without sketching the desired shape on a piece of 
graph paper to discover appropriate coordinate values. The drawPolygon() method uses the 
two arrays and the length of one of the arrays for the number of points. The program’s output 
appears in Figure 16-21. 





Figure 16-21 Output of the JStar program 


You can use the fi11Polygon() method to draw a solid shape. The major difference between 
the drawPolygon() and fi11Polygon() methods is that if the beginning and ending points 
used with the fi11Polygon() method are not identical, the two endpoints are connected by a 
straight line before the polygon is filled with color. 
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Rather than providing the fi11Polygon() method with three arguments, you can also create 
a Polygon object and pass the constructed object as a single argument to the fi11Polygon() 
method. The Polygon constructor requires an array of x-coordinates, an array of y- 
coordinates, and a size. For example, you can create a filled polygon using the following 


statements: 
903 








Polygon someShape = new Polygon(xPoints, yPoints, xPoints. length) ; 
gr.fi11Polygon(someShape) ; 


The Polygon class also has a default constructor, so you can instantiate an empty Polygon 
object (with no points) using the following statement: 


Polygon someFutureShape = new Polygon(); 


Whether you use the default constructor or not, you can add points to a polygon after 
construction. For example, you might want to add points that are determined by user input or 
mathematical calculations. You use the addPoint() method in statements such as the 
following to add points to the polygon later: 


someFutureShape.addPoint(100, 100); 
someFutureShape.addPoint(150, 200); 
someFutureShape.addPoint(50, 250); 


Points can be added to a polygon indefinitely. 


Copying an Area 


After you create a graphics image, you might want to create copies of the image. For example, 
you might want a company logo to appear several times in an application. Of course, you can 
redraw the picture, but you can also use the copyArea() method to copy any rectangular area 
to a new location. The copyArea() method requires six parameters: 


e The x- and y-coordinates of the upper-left corner of the area to be copied 
e The width and height of the area to be copied 
e The horizontal and vertical displacement of the destination of the copy 


For example, the following line of code causes a Graphics object named gr to copy an area 
20 pixels wide by 30 pixels tall from the upper-left corner of your JFrame (coordinates 0, 0) to 
an area that begins 100 pixels to the right and 50 pixels down: 


gr.copyArea(O, 0, 20, 30, 100, 50); 


Using the paintComponent() Method with JPanels 


When you create drawings on a JPanel (or other JComponent) instead of on a JFrame, you 
should use the paintComponent() method rather than the paintQ method. A JFrame’s 
paint() method automatically calls paintComponent() for its components, but JFrame is not 
a child of JComponent, so it does not have its own paintComponent() method. 
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For example, Figure 16-22 shows a JGraphicsPanel class that overrides JPanel]. Its 
constructor accepts a color to use as a background color. Its only method is a 
paintComponent() method that overrides the paintComponent() method in the JPane] class. 
The parameter Graphics object is passed to the parent class constructor, the drawing color is 


set to yellow, and two small circles are drawn. 
904 





import javax.swing.*; 
import java.awt.*; 
import java.awt.Color; 
public class JGraphicsPanel extends JPanel 
{ 
public JGraphicsPanel(Color color) 
{ 


setBackground(color) ; 


public void paintComponent(Graphics g) 
{ 
super.paintComponent(g) ; 
g.setColor(Color. YELLOW) ; 
g.f1110val1(10, 5, 40, 40); 
g.f1110val(60, 5, 40, 40); 





Figure 16-22 The JGraphicsPanel class 


Figure 16-23 contains a program that adds two JGraphicsPanel objects to a JFrame—one 
with a blue background and the other with a red background. Figure 16-24 shows the output, 
which displays two JPane1s that are placed side by side using a GridLayout. 


import javax.swing.*; 

import java.awt.*; 

import java.awt.Color; 

public class JGraphicsPanelFrame extends JFrame 

{ 
Container con = null; 
JGraphicsPanel pl = new JGraphicsPanel (Color.BLUE) ; 
JGraphicsPanel p2 = new JGraphicsPanel (Color.RED); 


public JGraphicsPanelFrame () 
{ 


con = this.getContentPaneQ) ; 
con.setLayout(new GridLayout(2,1)); 
con.add(p1) ; 

con.add(p2) ; 





Figure 16-23 The JGraphicsPanelFrame class (continues) 
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(continued) 


setSize(250, 250); 

setVisibleCtrue) ; 

setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
} 905 
public static void main(String args[]) 


{ 








JGraphicsPanelFrame app = new JGraphicsPanelFrame() ; 
app.setVisible(true) ; 
app.setSize(140, 140); 





Figure 16-24 Output of the JGraphicsPanelFrame program 


ee 
Eu Watch the video Drawing Lines and Shapes. 
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CHAPTER 16 Graphics 


Drawing Lines and Shapes 


906 1. You can use the drawLineQ method to draw a straight line between any two 
points on the screen. 





2. You can use methods named drawRect(), fillRect(), clearRectQ), 
drawO0val(), and fi110val1() to create a variety of shapes. 


3. When you draw an arc, the zero-degree position is at 12 o’clock on an imaginary 
clock, and the 90-degree position is at three o’clock. 
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aN You Do It 


Creating a Drawing 


Next, you add a simple line drawing to the JDemoCreateGraphicsObject2 program. 
The drawing appears after the user clicks the JButton enough times to disable 
the JButton. 


1. Open the JDemoCreateGraphicsObjectz2 file, and immediately save it as 
JDemoCreateGraphicsObject3.java. Change the class name, constructor 
name, and two references in the mainQ method to match. 


2. Replace the current if...e1se structure that tests whether y is less than LIMIT 
in the actionPerformed() method. Instead, use the following code, which 
tests the value of y and either draws the quote or disables the JButton and 
draws a picture. Set the drawing color to black, and create a simple drawing 
of a stick person that includes a head, torso, and two legs: 


if(y < LIMIT) 
pen.drawString(movieQuote, x += GAP, y += GAP); 
else 
{ 
moveButton. setEnabled(false) ; 
pen.setColor(Color.BLACK) ; 


(continues) 
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(continued) 


pen.drawOval (50, 170, 70, 70); 

pen.drawLine(85, 240, 90, 280); 
pen.drawLine(90, 280, 60, 380); 
pen.drawLine(90, 280, 110, 380); 907 








} 


3. Save the file, compile it, and execute it. After the movie quote moves to the 
LIMIT value, the JButton is disabled and the drawing appears, as shown 
in Figure 16-25. 


Here's locking at yeu, kid 


Here's locking at yeu, kid 


Here's lecking at yeu, kid 


Here's locking at yeu, kid 
Here's locking at yeu, kid 
Here's locking at yeu, kid 
Here's locking at yeu, kid 
Here's leckines at yeu, kid 
Here's leckines at yeu, kid 
Here's leckurs at yeu, kid 
Here's leckins at yeu, kid 
Here's leckins at yeu, 
Here's lecking at yt 
Here's leeks 2 


Here's leckint 





Figure 16-25 The JDemoCreateGraphicsObject3 program after 
the JButton is disabled 


4. Close the application. 


5. Modify the application so the drawing has more details, such as arms, feet, 
and a simple face. Save the revised application as 
JDemoCreateGraphicsObject4.java. 


(continues) 
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(continued) 
Copying an Area 


Next, you learn how to copy an area containing a shape that you want to appear 
908 several times on a JFrame. By copying, you do not have to re-create the shape 
each time. 





1. Open a new text file in your text editor, and then enter the beginning 
statements for a JFrame that uses the copyArea() method: 


import javax.swing.*; 

import java.awt.*; 

import java.awt.Color; 

public class JThreeStars extends JFrame 


{ 
2. Add the following statements, which create a polygon in the shape of a star: 


int xPoints[] = {42, 52, 72, 52, 
60, 40, 15, 28, 9, 32, 42}; 
int yPoints[] = {38, 62, 68, 80, 
105, 85, 102, 75, 58, 60, 38}; 
Polygon aStar = new Polygon(xPoints, yPoints, xPoints. length) ; 


3. Adda constructor that sets the default close operation: 


public JThreeStars() 
{ 


} 


4. Add the following paint( method, which sets a color, draws a star, and then 
draws two additional identical stars: 


setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE); 


public void paint(Graphics star) 

{ 
super.paint(star) ; 
star.setColor(Color.BLUE) ; 
star.drawPol ygon(aStar) ; 
star.copyArea(0, 0, 75, 105, 80, 40); 
star.copyArea(0, 0, 75, 105, 40, 150); 

} 


5. Adda mainQ method that instantiates a JThreeStars object and sets its 
size and visibility. Add a closing brace to end the class: 


public static void main(String[] args) 
{ 


JThreeStars frame = new JThreeStarsQ; 
frame.setSize(200, 300); 
frame.setVisible(true) ; 


} (continues) 
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(continued) 


6. Save the file as JThreeStars.java, and then compile the program. When you 
run the program, the output looks like Figure 16-26. 


909 




















Figure 16-26 Output of the JThreeStars program with one star 


7. Close the frame to end the application. 


8. Modify the program to add two more stars in any location you choose, save 
and compile the program, and confirm that the stars are copied to your 
desired locations. 


Learning More About Fonts 


As you add more components in your GUI applications, positioning becomes increasingly 
important. In particular, when you draw Strings using different fonts, it is difficult to place 
them correctly so they don’t overlap, making them difficult or impossible to read. In addition, 
the number of available fonts varies greatly across operating systems, so even when you define 
a font using a string argument such as “Arial” or “Courier”, you have no guarantee that the 
font will be available on every computer that runs your application. If a user’s computer does 
not have the requested font loaded, Java chooses a default replacement font, so you can never 
be completely certain how your output will look. Fortunately, Java provides many useful 
methods for obtaining information about the fonts you use. 


You can discover the fonts that are available on your system by using the 
getAvailableFontFamilyNames() method, which is part of the GraphicsEnvironment class 
defined in the java.awt package. The GraphicsEnvironment class describes the collection 
of Font objects and GraphicsDevice objects available to a Java application on a particular 
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platform. The getAvailableFontFami lyNames() method returns an array of String objects 
that are the names of available fonts. For example, the following statements declare a 
GraphicsEnvironment object named ge, and then use the object with the 

getAvai lableFontFami lyNames() method to store the font names in a string array: 


GraphicsEnvironment ge = 
GraphicsEnvironment.getLocalGraphicsEnvironment() ; 
String[] fontnames = ge.getAvailableFontFami 1lyNames() ; 


910 





Notice in the preceding example that you can’t instantiate the GraphicsEnvi ronment object 
directly. Instead, you must get a reference object to the current computer environment by 
calling the static getLocalGraphicsEnvironment() method. Figure 16-27 shows a JFrame 
that lists all the available font names on the computer on which the program was executed. 
After the GraphicsEnvironment object is created and the getAvai1ab1leFontFami lyNames () 
method is used to retrieve the array of font names, the names are displayed on the screen 
using a for loop in which the horizontal coordinate where each font String is drawn is 
increased by a fixed value so that five columns are displayed equally spaced across the JFrame 
surface. After five items are displayed, the horizontal coordinate is set back to 10 and the 
vertical coordinate is increased so that the next five-column row is displayed below the 
previous one. Typical output is shown in Figure 16-28. 


import javax.swing.*; 
import java.awt.*; 
public class JFontList extends JFrame 
{ 
public void paint(Graphics gr) 
{ 
super.paint(gr); 
int i, x, y = 40; 
final int VERTICAL_SPACE = 10; 
final int HORIZONTAL_SPACE = 160; 
GraphicsEnvironment ge = 
GraphicsEnvironment.getLocalGraphicsEnvironmentQ) ; 


String[] fontnames = ge.getAvailableFontFami lyNames() ; 
for(i = 0; i < fontnames. length; i += 5) 


{ 


x = 10; 
gr.setFont(new FontC"Arial", Font.PLAIN, 10)); 
gr.drawString(fontnames[i], x, y); 
ifGi + 1 < fontnames. length) 

gr.drawString(fontnames[i + 1], x += HORIZONTAL_SPACE, y); 
ifGi + 2 < fontnames. length) 

gr.drawString(fontnames[i + 2], x += HORIZONTAL_SPACE, y); 
ifGi + 3 < fontnames. length) 

gr.drawString(fontnames[i + 3], x += HORIZONTAL_SPACE, y); 





Figure 16-27 The JFontList class (continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


(continued) 


Leasing More About Forts iii 


ifGi + 4 < fontnames. length) 


gr.drawString(fontnames[i + 4], x += HORIZONTAL_SPACE, y); 


y = y + VERTICAL_SPACE; 


t 
} 


public static void main(String[] args) 


{ 


JFontList frame = new JFontListQ; 
frame.setSize(820, 620); 
frame.setVisible(true) ; 
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Figure 16-28 Typical output of the JFontList program 
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CHAPTER 16 Graphics 


Discovering Screen Statistics Using the Toolkit Class 


Frequently, before you can determine the best Font size to use, it is helpful to know statistics 
about the screen on which the Font will be displayed. For example, you can discover the 
resolution and screen size on your system by using the getScreenResolution() and 

912 getScreenSize() methods, which are part of the Toolkit class. 





The getDefaultToolkit() method provides information about the system in use. The 
getScreenResolution() method returns the number of pixels as an integer. You can create 
a Toolkit object and get the screen resolution using the following code: 


Toolkit tk = Toolkit.getDefaultToolkitQ; 
int resolution = tk.getScreenResolution() ; 


The Dimension class is useful for representing the width and height of a user interface 
component, such as a JFrame or a JButton. The Dimension class has three constructors: 


e The Dimension® method creates an instance of Dimension with a width of 0 anda 
height of 0. 


e Dimension(Dimension d) creates an instance of Dimension whose width and height are 
the same as for the specified dimension. 


e DimensionCint width, int height) constructs a Dimension and initializes it to the 
specified width and height. 


The getScreenSize() method, a member of the Toolkit object, returns an object of type 
Dimension, which specifies the width and height of the screen in pixels. Knowing the number 
of pixels for the width and height of your display is useful to set the coordinates for the 
position, width, and height of a window. For example, the following code stores the width and 
height of a screen in separate variables: 


Toolkit tk = Toolkit.getDefaultToolkitQ; 
Dimension screen = tk.getScreenSize() ; 
int width = screen.width; 

int height = screen.height; 


Discovering Font Statistics 


Typesetters and desktop publishers measure the height of every font in three parts: ascent, 
descent, and leading. Ascent is the height of an uppercase character from a baseline to the top 
of the character. Descent measures the part of characters that “hang below” the baseline, such 
as the tails on the lowercase letters g and j. Leading (pronounced /edding) is the amount of 
space between the bottom of the descent of one line and the top of the characters in the 
successive line of type. The height of a font is the sum of the leading, ascent, and descent. 
Figure 16-29 labels each of these measurements. 
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Figure 16-29 Parts of a font’s height 


You can discover a font’s statistics by first using the Graphics class getFontMetrics() method 
to return a FontMetrics object, and then by using one of the following FontMetrics class 
methods with the object to return one of a Font’s statistics: 


e public int getLeading() 
e public int getAscent() 
e public int getDescent() 


e public int getHeight() 


Another method, getLineMetrics(), is more complicated to use but returns similar font statistics. For 
Y more details, see the Java Web site. 


Each of these methods returns an integer value representing the font size in points (one point 
measures 1/72 of an inch) of the requested portion of the Font object. For example, if you 
define a Font object named myFont and a Graphics object named paintBrush, you can set the 
current font for the Graphics object by using the following statements: 


paintBrush.setFont(myFont) ; 
int heightOfFont = paintBrush.getFontMetrics() .getHeight(); 


When you define a Font object, you use point size. However, when you use the FontMetrics get 
Y methods, the sizes are returned in pixels. 


Then the heightOfFont variable holds the total height of myFont characters. 


A practical use for discovering the height of a font is to space Strings correctly as you display 
them. For example, instead of placing every String in a series vertically equidistant from the 
previous String with a statement such as the following: 


pen.drawStringC("Some string", x, y += INCREASE); 
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(where INCREASE has been defined as a constant), you can make the actual increase in the 
vertical position dependent on the font. If you code the following, you are assured that 
each String has enough room, regardless of which font is currently in use by the Graphics 
pen object: 


pen.drawString("Some string", 


914 xX, y t= pen.getFontMetrics() .getHeightQ); 





When you create a String, you know how many characters are in the String. However, you 
cannot be certain which font Java will use or substitute, and because fonts have different 
measurements, it is difficult to know the exact width of the String that appears in a JFrame. 
Fortunately, the FontMetrics class contains a stringWidth() method that returns the 
integer width of a String. As an argument, the stringWidth() method requires the name 
of a String. For example, if you create a String named myString, you can retrieve the 
width of myString with the following code: 


int width = gr.getFontMetrics().stringwidth(myString) ; 


ee 
= Watch the video Font Methods. 


Learning More About Fonts 


1. Java is widely used partly because its fonts are guaranteed to look the 
same on all computers. 


2. You can discover the resolution and screen size on your system by using 
the getScreenResolution® and getScreenSize() methods, which are part 
of the Toolkit class. 


3. Ascent is the height of an uppercase character from a baseline to the top 
of the character, and descent measures the part of characters that “hang 
below” the baseline, such as the tail on the lowercase letter y. 
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\ You Do It 


Using FontMetrics Methods to Compare Fonts 
915 








Next, you write a program to demonstrate FontMetrics methods. You will create 
three Font objects and display their metrics. 


1. Open anew text file in your text editor, and then enter the first few lines of the 
JDemoFontMetrics program: 


import javax.swing.*; 
import java.awt.*; 
public class JDemoFontMetrics extends JFrame 


{ 


2. Type the following code to create a String and a few fonts to use for 
demonstration purposes: 


String movieQuote = 
new String("'Go ahead, make my day") ; 

Font courierItalic = new Font("Courier New", Font.ITALIC, 16), 
timesPlain = new Font("Times New Roman", Font.PLAIN, 16), 
scriptBold = new Font("Freestyle Script", Font.BOLD, 16); 


3. Add the following code to define four integer variables to hold the four font 
measurements, and two integer variables to hold the current horizontal and 
vertical output positions within the JFrame: 


int ascent, descent, height, leading; 
int x= 20, y=50; 


4. Within the jFrame, you will draw Strings positioned 40 pixels apart vertically. 
After each of those Strings, the Strings that hold the statistics will be 15 
pixels apart. Type the following statements to create constants to hold these 
vertical increase values: 


final int INCREASE SMALL = 15; 
final int INCREASE LARGE = 40; 


5. Adda constructor as follows: 


publ ic JDemoFontMetricsQ 
{ 


} 


6. Add the following statements to start writing a paint© method. Within the 
method, you set the Font to courierItalic, draw the phrase String to show 
a working example of the font, and then call a displayMetrics( method 


setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


(continues) 
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(continued) 


that you will write in Step 7. Pass the Graphics object to the 
displayMetrics© method, so the method can discover the sizes 
916 associated with the current font. Perform the same three steps using the 
timesPlain and scriptBold fonts. 





public void paint (Graphics pen) 

{ 
super.paint (pen) ; 
pen.setFont(courierlItalic) ; 
pen.drawString(moviequote, x, y); 
displayMetrics(pen) ; 
pen.setFont(timesPlain) ; 
pen.drawString(moviequote, x, y += INCREASE_LARGE) ; 
displayMetrics(pen) ; 
pen.setFont(scriptBold) ; 
pen.drawString(moviequote, x, y += INCREASE_LARGE) ; 
displayMetrics(pen) ; 

} 


7. Next, add the header and opening curly brace for the displayMetricsQ 
method. The method will receive a Graphics object from the paint@ method. 
Add the following statements to call the four getFontMetrics() methods to 
obtain values for the leading, ascent, descent, and height variables: 


public void displayMetrics(Graphics metrics) 

{ 
leading = metrics.getFontMetrics( .getLeadingQ ; 
ascent = metrics.getFontMetrics() .getAscent(); 
descent = metrics.getFontMetrics() .getDescent() ; 
height = metrics.getFontMetricsQ .getHeightQ ; 


8. Add the following four drawStringQ statements to display the values. Use 
the expression y += INCREASE_SMALL to change the vertical position of each 
String by the constant. 


metrics.drawString("Leading is " + leading, 
x, y += INCREASE SMALL) ; 

metrics.drawString("Ascent is 
x, y += INCREASE SMALL); 

metrics.drawString("Descent is 
x, y += INCREASE SMALL); 

metrics.drawString("Height is 
x, y += INCREASE SMALL); 


+ ascent, 


+ descent, 


+ height, 


(continues) 
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(continued) 


9. Add amainQ method, and include a closing curly brace for the class: 


public static void main(String[] args) 








{ 917 
JDemoFontMetrics frame = new JDemoFontMetrics(); 
frame.setSize(250, 350); 
frame.setVisible(true) ; 

} 


i 


10. Save the file as JDemoFontMetrics.java, and then compile it. When you 
run the program, the output should look like Figure 16-30. Notice that even 
though each Font object was constructed with a size of 16, the individual 
statistics vary for each Font object. 


Go ahead, make my day 
Leading is 0 
Ascent is id 
Descent is 5 
Height is i9 


Go ahead, make my day 
Leading is 0 


Ascentis 15 
Descent ts 4 
Height is 19 





Figure 16-30 Output of the JDemoFontMetrics program 


11. Close the frame to end the program. 


(continues) 
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(continued) 
Using FontMetrics Methods to Place a Border Around a String 


Next, you use the FontMetrics methods to draw a rectangle around a String. 
Instead of guessing at appropriate pixel positions, you can use the height and width 
of the String to create a box with borders placed symmetrically around the String. 
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1. Open anew file in your text editor, and enter the first few lines of a JBoxAround 
JFrame: 
import javax.swing.*; 
import java. awt.*; 
public class JBoxAround extends JFrame 


{ 


2. Enter the following statements to add a String, a Font, and variables to hold 
the font metrics and x- and y-coordinates: 


String movieQuote = 
new String("An offer he can’t refuse"); 
Font serifItalic = new Font("Serif", Font. ITALIC, 20); 
int leading, ascent, height, width; 
int x= 40, y=60; 


3. Create the following named constant that holds a number indicating the 
dimensions in pixels of the rectangle that you draw around the string: 


static final int BORDER = 5; 
4. Add aconstructor as follows: 


public JBoxAround() 
{ 


} 


5. Add the following paint© method, which sets the font, draws the String, 
and obtains the font metrics: 


setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE); 


public void paint (Graphics gr) 
{ 
super.paint(gr) ; 
gr.setFont(serifitalic); 
gr.drawString(movieQuote, x, y); 
leading = gr.getFontMetrics() .getLeading() ; 
ascent = gr.getFontMetrics() .getAscent(); 
height = gr.getFontMetrics() .getHeightQ ; 
width = gr.getFontMetrics() .stringWidth(movieQuote) ; 


(continues) 
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(continued) 


6. Draw a rectangle around the string using the following drawRectQ method. 
In Figure 16-31, the x- and y-coordinates of the upper-left edge are set at 
x - BORDER, y - (ascent + leading + BORDER). The proper width and 919 
height are then determined to draw a uniform rectangle around the string. 








The values of the x- and y-coordinates used in the drawString@ method 
indicate the left side of the baseline of the first character in the String. You 
want to position the upper-left corner of the rectangle five pixels to the left 
of the String, so the first argument to drawRect() Is five less than x, or 

x - BORDER. The second argument to drawRect() is the y-coordinate of the 
String minus the ascent of the String, minus the leading of the String, 
minus five, or y - (ascent + leading + BORDER). The final two arguments 
to drawRect( are the width and height of the rectangle. The width is 

the String’s width plus five pixels on the left and five pixels on the right. 
The height of the rectangle is the String’s height, plus five pixels above the 
String and five pixels below the String. 


gr.drawRect(x - BORDER, y - (ascent + leading + BORDER), 
width + 2 * BORDER, height + 2 * BORDER); 
} 


7. Add the following main® method and a closing brace for the class: 


public static void main(String[] args) 


{ 


JBoxAround frame = new JBoxAroundQ ; 
frame.setSize(330, 100); 
frame.setVisible(true) ; 


i 


8. Save the file as JBoxAround.java. Compile and execute it. Your output 
should look like Figure 16-31. 


An offer he can't refuse 


Figure 16-31 Output of the JBoxAround program 





9. Experiment with changing the contents of the String, the x and y starting 
coordinates, and the value of the BORDER constant. Confirm that the rectangle 
is drawn symmetrically around any String object. 
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Drawing with Java 2D Graphics 


Drawing operations earlier in this chapter were called using a Graphics object—either an 
automatically generated one that was passed to the paint() method or one the programmer 
instantiated. In addition, you can call drawing operations using an object of the Graphics2D 
920 class. The advantage of using Java 2D objects is the higher-quality, two-dimensional (2D) 
graphics, images, and text they provide. 





Features of some of the 2D classes include: 

e Fill patterns, such as gradients 

e Strokes that define the width and style of a drawing stroke 

e Anti-aliasing, a graphics technique for producing smoother screen graphics 


Graphics2D is found in the java.awt package. A Graphics2D object is produced by casting, or 
converting and promoting, a Graphics object. For example, in a paint() method that 
automatically receives a Graphics object, you can cast the object to a Graphics2D object 
using the following code to start the method: 


public void paint(Graphics pen) 
{ 
Graphics2D newpen = (Graphics2D)pen; 


The process of drawing with Java 2D objects includes: 
e Specifying the rendering attributes 
e Setting a drawing stroke 


e Creating objects to draw 


Specifying the Rendering Attributes 


The first step in drawing a 2D object is to specify how a drawn object is rendered. Whereas 
drawings that are not 2D can only use the attribute Color, with 2D you can designate other 
attributes, such as line width and fill patterns. You specify 2D colors by using the setColorQ 
method, which works like the Graphics method of the same name. Using a Graphics2D 
object, you can set the color to black using the following code: 


gr2D.setColor(Color.BLACK) ; 


Fill patterns control how a drawing object is filled in. In addition to using a solid color, 2D 
fill patterns can be a gradient fill, a texture, or even a pattern that you devise. A fill pattern 
is created by using the setPaint() method of Graphics2D with a fill pattern object as the 
only argument. Classes from which you can construct a fill pattern include Color, 
TexturePaint, and GradientPaint. 


A gradient fill is a gradual shift from one color at one coordinate point to a different color at 
a second coordinate point. If the color shift occurs once between the points—for example, 
slowly changing from yellow to red—you are using an acyclic gradient, one that does not 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce! earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 





Drawing with Java 2D Graphics D0 


cycle between the colors. If the shift occurs repeatedly, such as from yellow to red and back to 
yellow again, you are using a cyclic gradient, one that does cycle between the colors. 


Figure 16-32 shows an application that demonstrates acyclic and cyclic gradient fills. The 
first shaded setPaint() method call sets a gradient that begins at coordinates 20, 40 in 
LIGHT_GRAY and ends at coordinates 180, 100 in DARK_GRAY. The last argument to the 
GradientPaint© constructor is false, indicating an acyclic gradient. After the Graphics2D 
object’s paint is applied, a filled rectangle is drawn over the same area. These statements 
produce the rectangle on the left in Figure 16-33, which gradually shifts from light gray to 
dark gray, moving down and to the right. The second shaded setPaint( statement in Figure 
16-32 establishes a new gradient beginning farther to the right. In this statement, the final 
argument to GradientPaint() is true, creating a cyclic gradient. As you can see on the right 
side in Figure 16-33, this rectangle’s shading changes gradually across its surface. 
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Later in this chapter, you will learn about the Rectangle2D.Doubl1e class used to create the rectangles 
GY in this application. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.geom.*; 
import java.awt.Color; 
public class JGradient extends JFrame 
{ 
public void paint(Graphics gr) 
{ 
super.paint(gr); 
int x = 20, y = 40, x2 = 180, y2 = 100; 
Graphics2D gr2D = (Graphics2D)gr; 
gr2D.setPaint(new GradientPaint(x, y, Color.LIGHT_GRAY, 
x2, y2, Color.DARK_GRAY, false)); 


gr2D.f111(new Rectangle2D.Double(x, y, x2, y2)); 

x = 210; 

gr2D.setPaint(new GradientPaint(x, y, Color.LIGHT_GRAY, 
x2, y2, Color.DARK_GRAY, true)); 

gr2D.f111(new Rectangle2D.Double(x, y, x2, y2)); 


} 

public static void main(String[] args) 

{ 
JGradient frame = new JGradientQ); 
frame.setSize(440, 180); 
frame.setVisible(true); 





Figure 16-32 The JGradient class 
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Figure 16-33 Output of the JGradient application 


Setting a Drawing Stroke 


All lines in non-2D graphics operations are drawn as solid, with square ends and a line width 
of one pixel. With the 2D methods, the drawing line is a stroke, which represents a single 
movement as if you were using a drawing tool, such as a pen or a pencil. In Java 2D, you can 
change a stroke’s width using the setStroke() method. Stroke is actually an interface; the 
class that defines line types and implements the Stroke interface is named BasicStroke. A 
BasicStroke constructor takes three arguments: 


e A float value representing the line width 
e An int value determining the type of cap decoration at the end of a line 
e An int value determining the style of juncture between two line segments 


BasicStroke class variables determine the endcap and juncture style arguments. Endcap 
styles apply to the ends of lines that do not join with other lines, and include CAP_BUTT, 
CAP_ROUND, and CAP_SQUARE. Juncture styles, for lines that join, include JOIN_MITER, 
JOIN_ROUND, and JOIN_BEVEL. 


The following statements create a BasicStroke object and make it the current stroke: 


BasicStroke aLine = new BasicStroke(1.0f, 
BasicStroke.CAP_ROUND, BasicStroke.JOIN_ROUND) ; 


Figure 16-34 shows a program that draws a rectangle using a very wide stroke. 
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import javax.swing.*; 

import java.awt.*; 

import java.awt.geom.*; 

public class JStroke extends JFrame 

{ 923 
public void paint(Graphics gr) 
{ 








super.paint(gr); 

Graphics2D gr2D = (Graphics2D)gr; 

BasicStroke aStroke = new BasicStroke(15.0f, 
BasicStroke.CAP_ROUND, BasicStroke.JOIN_ROUND) ; 


gr2D.setStroke(aStroke) ; 

gr2D.draw(new Rectangle2D.Double(40, 40, 100, 100)); 
} 
public static void main(String[] args) 
{ 

JStroke frame = new JStrokeQ); 

frame.setSize(180, 180); 

frame.setVisible(true) ; 





Figure 16-34 The JStroke class 


The shaded statement in the JStroke class sets the BasicStroke width to 15 pixels using 
round endcap and juncture parameters. Notice that the line width value is followed by an f, 
making the value a float instead of a double. Figure 16-35 shows the drawn rectangle. 





Figure 16-35 Output of the JStroke program 


Creating Objects to Draw 


After you have created a Graphics2D object and specified the rendering attributes, you can 
create different objects to draw. Objects that are drawn in Java 2D are first created by defining 
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them as geometric shapes using the java. awt .geom package classes. You can define the shape 
of lines, rectangles, ovals, and arcs; after you define the shape, you use it as an argument to the 
draw() or £1110 methods. The Graphics2D class does not have different methods for each 
shape you can draw. 


924 Lines 


Lines are created using the Line2D.Float class or the Line2D.Double class. Each of these 
classes has a constructor that takes four arguments, which are the x- and y-coordinates of the 
line endpoints. For example, to create a line from the endpoint 60, 5 to the endpoint 13, 28, 
you could write the following: 





Line2D.Float line = new Line2D.Float(60F, 5F, 13F, 28F); 


It also is possible to create lines based on points. You can use the Point2D.Float or Point2D. 
Double class to create points that have both x- and y-coordinates. For example, you could 
create two Point2D.Float points using the following code: 


Point2D.Float posl = new Point2D.Float(60F, 5F); 
Point2D.Float pos2 = new Point2D.Float(13F, 28F); 


Then the code to create a line might be: 


Line2D.Float line = new Line2D.Float(posl1, pos2); 


Rectangles 


You can create rectangles by using a Rectangle2D.Float or a Rectangle2D.Doub1e class. As 
with the Line and Point classes, these two classes are distinguished by the type of argument 
used to call their constructors: float or double. Both Rectangle2D.Float and Rectangle2D. 
Double can be created using four arguments representing the x-coordinate, y-coordinate, 
width, and height. For example, the following code creates a Rectangle2D.Float object 
named rect at 10, 10 with a width of 50 and height of 40: 


Rectangle2D.Float rect = new Rectangle2D.Float(10F, 10F, SOF, 40F); 


Ovals 


You can create Oval objects with the Ellipse2D.Float or El1lipse2D.Double class. The 
E1lipse2D.Float constructor requires four arguments representing the x-coordinate, y- 
coordinate, width, and height. The following code creates an E1lipse2D.Float object named 
ell at 10, 73 with a width of 40 and height of 20: 


Ellipse2D.Float ell = new Ellipse2D.Float(10F, 73F, 40F, 20F); 
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Arcs 


You can create arcs with the Arc2D.Float or Arc2D.Double class. The Arc2D. Float 

constructor takes seven arguments. The first four arguments represent the x-coordinate, y- 
coordinate, width, and height that apply to the ellipse of which the arc is a part. The 

remaining three arguments are as follows: 925 








e The starting position of the arc 
e The number of degrees it travels 
e An integer field indicating how it is closed 


The starting position is expressed in degrees in the same way as in the Graphics class drawArc() 
method; for example, 0 is the three o’clock position. The number of degrees traveled by the arc 
is specified in a counterclockwise direction using positive numbers. The final argument uses one 
of the three class fields: 


e Arc2D.PIE connects the arc to the center of an ellipse and looks like a pie slice. 
e Arc2D.CHORD connects the arc’s endpoints with a straight line. 
e Arc2D.OPEN is an unclosed arc. 


To create an Arc2D.Float object named ac at 10, 133 with a width of 30 and height of 33, a 
starting degree of 30, 120 degrees traveled, and using the class variable Arc2D.PIE, you use the 
following statement: 


Arc2D.Float ac = new Arc2D.Float(10,133,30,33,30,120,Arc2D.PIE); 


Polygons 


You create a Polygon object by defining movements from one point to another. The 
movement that creates a polygon is a GeneralPath object; the GeneralPath class is found in 
the java. awt.geom package. 


e The statement GeneralPath pol = new GeneralPathQ); creates a GeneralPath object 
named pol. 


e The moveTo() method of GeneralPath is used to create the beginning point of the 
polygon. Thus, the statement pol.moveTo(10F, 193F); starts the polygon named pol at 
the coordinates 10, 193. 


e The lineTo() method is used to create a line that ends at a new point. The statement 
pol. lineTo(25F, 183F); creates a second point using the arguments of 25 and 183 as the 
x- and y-coordinates of the new point. 


e The statement pol.lineTo(100F, 223F); creates a third point. The lineToO method 
can be used to connect the current point to the original point. Alternatively, you can use 
the closePath() method without any arguments. 
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«a You Do It 


Drawing with Java 2D Graphics 


The advantage of using Java 2D objects is the higher-quality, 2D graphics, 
images, and text they provide. 


With Java’s 2D graphics, you can designate attributes such as color, line width, 
and fill patterns. 


With Java’s 2D methods, the drawing line is a brush that represents a single 
movement as if you were using a drawing tool, such as a pen or a pencil. 
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Using Drawing Strokes 


Next, you create a line with a drawing stroke to illustrate how it can have different 
end types and juncture types where lines intersect. 


le 


Open a new file in your text editor, and then enter the first few lines of a 
J2DLine JFrame. (Note that you are importing the java.awt.geom package.) 
import javax.swing.*; 

import java.awt.*; 

import java.awt.geom.*; 

public class J2DLine extends JFrame 


{ 
Add a constructor: 


public J2DLine() 
{ 


} 


Enter the following statements to create a paint() method, create 
a Graphics environment gr, and cast the Graphics environment to a 
Graphics2D environment gr2D. Create x- and y-points with the 
Point2D.Float Class. 


setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


(continues) 
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(continued) 


public void paint (Graphics gr) 
{ 





super.paint(gr) ; 927 
Graphics2D gr2D = (Graphics2D)gr; 
Point2D.Float posl = new Point2D.Float(80, 50); 
Point2D.Float pos2 = new Point2D.Float(20, 100); 





4. Create a BasicStroke object, and then create a drawing stroke named aStroke. 
Note that the line width is set to 15 pixels, and the endcap style and juncture 
style are set to CAP_ROUND and JOIN_MITER, respectively. 


BasicStroke aStroke = new BasicStroke(15.0f, 
BasicStroke.CAP_ROUND, BasicStroke. JOIN MITER); 


5. Add the following code to create a line between the points posi and pos2, and 
draw the line: 


gr2D.setStroke(aStroke) ; 
Line2D.Float line = new Line2D.Float(posl, pos2); 
gr2D.draw(1 ine) ; 

} 


6. Add amainQ method and the closing curly brace for the class: 


public static void main(String[] args) 
{ 
J2DLine frame = new J2DLineQ; 
frame.setSize(100, 120); 
frame.setVisible(true) ; 


} 


7. Save the file as J2DLine.java, and then compile and execute it. Your output 
should look like Figure 16-36. 





Figure 16-36 Output of the J2DLine program 


(continues) 
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(continued) 


8. Experiment by making the JFrame size larger and adding more lines to create 
an interesting design. 
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Working with Shapes 


Next, you use the Java 2D drawing object types to create a JFrame that illustrates 
sample rectangles, ovals, arcs, and polygons. 


1. Open anew file in your text editor, and then enter the first few lines of a 
JShapes2D JFrame: 


import javax.swing.*; 

import java.awt.*; 

import java.awt.geom. *; 

public class JShapes2D extends JFrame 
{ 


2. Adda constructor that sets the default close operation as follows: 


public JShapes2D() 
{ 


i 


3. Enter the following statements to create a paint© method, create a 
Graphics environment gr, and cast the Graphics environment to 
a Graphics2D environment gr2D: 


setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE); 


public void paint(Graphics gr) 
{ 
super.paint(gr) ; 
Graphics2D gr2D = (Graphics2D)gr; 


4. Create two Rectangle2D.Float objects named rect and rect2. Draw the 
rect object and fill the rect2 object: 


Rectangle2D. Float rect = 

new Rectangle2D.Float(20F, 40F, 40F, 40F); 
Rectangle2D.Float rect2 = 

new Rectangle2D.Float(20F, 90F, 40F, 40F); 
gr2D.draw(rect) ; 
gr2D. fill (Crect2); 


(continues) 
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(continued) 


5. Create two Ellipse2D.Float objects named ellipse and ellipse2. Draw 
the ellipse object and fill the ellipse2 object: 


Ellipse2D.Float ellipse = new 929 


Ellipse2D.Float(20F, 140F, 40F, 40F); 
Ellipse2D.Float ellipse2 = new 

Ellipse2D.Float(20F, 190F, 40F, 40F); 
gr2D.draw(ellipse) ; 
gr2D.fi11(Cellipse2); 








6. Create two Arc2D.Float objects named ac and ac2. Draw the ac object and 
fill the ac2 object: 


Arc2D.Float ac = new 

Arc2D.Float(20, 240, 50, 50, 30, 120, Arc2D.PIE); 
Arc2D.Float ac2 = new 

Arc2D.Float(20, 290, 50, 50, 30, 120, Arc2D.PIE); 
gr2D.draw(ac) ; 
gr2D.fi11(ac2); 


7. Create a new GeneralPath object named pol. Set the starting point of the 
polygon and create two additional points. Use the closePath() method to 
close the polygon by connecting the current point to the starting point. Draw 
the pol object, and then end the method with a curly brace: 


GeneralPath pol = new GeneralPath() ;5 
pol .moveTo(20F, 320F) ; 
pol .1ineTo(40F, 380F) ; 
pol .1 ineTo(C100F , 400F) ; 
pol .closePathQ) ;5x 
gr2D.draw(pol); 
} 


8. Add amainQ method and the final curly brace for the class: 


public static void main(String[] args) 
{ 
JShapes2D frame = new JShapes2D(); 
frame.setSize(100, 420); 
frame.setVisible(true) ; 


} 


9. Save the file as JShapes2D.java, and compile and execute the program. 
Your output should look like Figure 16-37. When you are ready, close the 
window, and then experiment with making changes to the program to 
produce different shapes. 


(continues) 
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(continued) 
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Figure 16-37 Output of the JShapes2D program 


Don't Do It 


e Don't forget to call super.paint( as the first statement in the paint() method when 
you write a class that extends JFrame. Failing to do so can cause odd results, especially 
when you combine GUI widgets with graphics. 


e Don't forget that the setLocation© method works correctly only when it is used after 
the layout manager has finished positioning all the application’s components (or in cases 
where no layout manager is functioning). 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


e Don't forget that the lower-left corner of a String is placed at the coordinates used when 
you call drawString(). 


e Don't forget to use paintComponent() rather than paint() when creating graphics on a 
JPanel. 
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Key Terms 


To rerender a drawing is to repaint or redisplay it. 
Painting is the act of redisplaying a surface. 


System-triggered painting operations occur when the system requests a component to 
render its contents. 


Application-triggered painting operations occur when the internal state of a component has 
changed. 


The paint() method runs when Java displays a screen; you can write your own paint() 
method to override the automatically supplied one whenever you want to paint graphics such 
as shapes on the screen. 


The Graphics class is an abstract class that descends directly from Object and holds data 
about graphics operations and methods for drawing shapes, text, and images. 


The repaint( method updates a window when it contains new images. 


The setLocation() method allows you to place a component at a specific location within a 
JFrame’s content pane. 


The drawString() method allows you to draw a String in a JFrame or other component. 
The drawLineQ) method draws a straight line between any two points on the screen. 
The drawRect() method draws the outline of a rectangle. 


The fil1Rect(© method draws a solid, or filled, rectangle. 










The clearRect() method draws a rectangle using the background color to create what 
appears to be an empty or “clear” rectangle. 


The drawRoundRect() method draws rectangles with rounded corners. 
An arc is a portion of a circle. 


The draw3DRect() method draws a rectangle that appears to have “shadowing” on two of its 
edges—the effect is that of a rectangle that is lit from the upper-left corner and slightly raised 
or slightly lowered. 


The fi113DRect() method creates filled, 3D rectangles. 
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The drawOval () method draws an oval. 
The fi1110val() method draws a solid, filled oval. 
The drawArc(Q) method draws an arc. 


932 The fi11ArcQ method creates a solid arc. 





The drawPolygon() method draws complex shapes. 

The fi11Polygon(Q) method draws a solid complex shape. 

The addPoint() method adds points to a Polygon object. 

The copyArea() method copies any rectangular area to a new location. 


The getAvailableFontFamilyNames() method returns the fonts that are available on your 
system. 


The getDefaultToolkit() method provides information about the system in use. 
The getScreenResolution() method returns the screen resolution on the current system. 
The getScreenSize() method returns the screen size as a Dimension object. 


Ascent is one of three measures of a Font’s height; it is the height of an uppercase character 
from a baseline to the top of the character. 


Descent is one of three measures of a Font’s height; it measures the part of characters that 
“hang below” the baseline, such as the tails on the lowercase letters g and j. 


Leading is one of three measures of a Font’s height; it is the amount of space between the 
bottom of the descent of one line and the top of the characters in the successive line of type. 


The height of a font is the sum of its leading, ascent, and descent. 


The getFontMetrics() method in the Graphics class returns a FontMetrics object; with it 
you can discover many characteristics of a Font object. 


The stringWidth() method in the FontMetrics class contains the integer width of a String. 


The Graphics2D class provides tools for 2D drawing. 










Fill patterns control how a drawing object is filled in. 


A gradient fill is a gradual shift from one color at one coordinate point to a different color at a 
second coordinate point. 


An acyclic gradient is a fill pattern in which a color shift occurs once between two points. 


A cyclic gradient is a fill pattern in which a shift between colors occurs repeatedly between 
two points. 


A stroke is a line-drawing feature in Java 2D that represents a single movement as if you were 
using a drawing tool, such as a pen or a pencil. 


The setStroke() method changes a stroke’s width in Java 2D. 
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BasicStroke is the class that defines line types and implements the Stroke interface. 


Endcap styles apply to the ends of lines that do not join with other lines, and include 
CAP_BUTT, CAP_ROUND, and CAP_SQUARE. 


Juncture styles, for lines that join, include JOIN_MITER, JOIN_ROUND, and JOIN_BEVEL. 


Chapter Summary 


Painting operations can be system triggered or application triggered. Painting operations 
are performed by a Component’s paint() method, which takes a Graphics argument that 
renders output. You override the paint() method in your programs when you want 
specific actions to take place when components must be rendered. The setLocationQ 
method allows you to place a component at a specific location within a JFrame’s content 
pane. 


The drawStringQ method allows you to draw a String. The method requires three 
arguments: a String, an x-axis coordinate, and a y-axis coordinate. The drawStringQ 
method is a member of the Graphics class, so you need to use a Graphics object to call it. 
You can improve the appearance of strings drawn using Graphics objects by using the 
setFont() and setColor() methods. 


Java provides you with several methods for drawing a variety of lines and geometric 
shapes, such as drawLine(), drawRect(), drawOval(), drawPolygon(), and others. You 
can also use the copyArea() method to copy any rectangular area to a new location. 


If a user’s computer does not have a requested font, Java chooses a default replacement 
font. You can discover the fonts that are available on your system by using the 

getAvai lableFontFamilyNames() method, which is part of the GraphicsEnvironment 
class. This class describes the collection of Font objects and GraphicsDevice objects 
available to a Java application on a particular platform. You can discover the resolution and 
screen size on your system by using the getScreenResolution() and getScreenSize() 
methods, which are part of the Toolkit class. The height of every font is the sum of three 
parts: ascent, descent, and leading. 


The advantage to using Graphics2D objects is the higher-quality 2D graphics, images, and 
text they provide. With 2D you can designate attributes such as line width and fill 
patterns. 


Review Questions 
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1. Repainting of a visible surface is triggered by 


a. the operating system c. either of these 
b. the application d. none of these 


deemed that any suppressed content does not materially affect the overall learning experience. reserves the right to remove additi 





933 











CHAPTER 16 Graphics 


934 














The method that calls the paintQ) method for you is 


a. callPaintQ c. requestPaint() 

b. repaintQO d. draw(Q) 

The paint() method header requires a(n) ___________ argument. 
a. void c. String 

b. integer d. Graphics 


The setLocation() method 


a. is used to position a JFrame on the screen 

b. is used to set regional and national preferences for an application 
c. takes two integer arguments that represent position coordinates 
d. must be used with every component placed on a JFrame 

The statement g.drawString(someString, 50, 100); places 
someString’s _____________ corner at position 50, 100. 

a. upper-left c. upper-right 

b. lower-left d. lower-right 


If you use the setColor() method to change a Graphics object’s color to 
yellow, 
a. only the next output from the object appears in yellow 


b. all output from the object for the remainder of the method always appears in 
yellow 


c. all output from the object for the remainder of the application always appears 
in yellow 


d. all output from the object appears in yellow until you change the color 


The correct statement to instantiate a Graphics object named picasso 
is 

Graphics picasso; 

Graphics picasso = new Graphics(); 


Graphics picasso = getGraphics(); 


oo Ff SP 


Graphics picasso = getGraphics (new) ; 
The statement g.drawRoundRect(100, 100, 100, 100, 0, 0); draws a shape 
that looks most like a 


a. square c. circle 
b. round-edged rectangle d. straight line 
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10. 


11. 


12. 


13. 


14. 


15. 
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If you draw an oval with the same value for width and height, you draw 








a(n) 
a. circle c. rounded square 
b. square d. ellipsis 
7 : eis 935 
The zero-degree position for any arc is at the _______ o clock position. 
a. three c. nine 
b. six d. twelve 


The method you use to create a solid arc is 


a. solidArc(Q) c. arcSolidQ 

b. fiTTArcQ d. arcFil1Q 

You use the __________ method to copy any rectangular area to a new location. 
a. copyRectQ c. repeatRect() 

b. copyArea() d. repeatArea() 


The measurement of an uppercase character from the baseline to the top of the 
character is its 

a. ascent c. leading 

b. descent d. height 


To be certain that a vertical series of Strings has enough room to appear in a 
frame, you use which of the following statements? 


a. g-.drawString("Some string", 

xX, y t= g.getFontMetrics() .getHeightQ); 
b. g.drawString("Some string", 

xX, y t= g.getFontMetrics() .getLeadingQ); 
c. g.drawStringC"Some string", x, 

y t= g.getFontMetrics(Q .getAscent()); 
d. g.drawString("Some string", 

xX, y t= g.getFontMetrics() .getDescentQ)); 









You can discover the fonts that are available on your system by using 

the 

getAvai lableFontFamilyNames() method of the GraphicsEnvironment class 
getFonts() method of the Graphics class 

getMyFonts() method of the GraphicsFonts class 


ao Ff PS 


getAl1Fonts() method of the Fonts class 
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16. The getScreenResolution() method and getScreenSize() method 
a. both return the number of pixels as an int type 
respectively return the number of pixels as an int type and an object of type 
Dimension 
936 c. both return an object of type Dimension 
d. respectively return the number of pixels as a doub1e type and an object of type 
Dimension 
17. A Graphics2D object is produced by 
a. the setGraphics2D() method 
b. the Graphics2D newpen = Graphics2D() statement 
c. the Graphics2D = Graphics(g) statement 
d. casting a Graphics object 
18. The process of drawing with Java 2D objects includes 
a. specifying the rendering attributes 
b. setting a drawing stroke 
c. both of the above 
d. none of the above 
19. A gradient fill is a gradual change in 
a. color c. drawing style 
b. font size d. line thickness 
20. With the 2D methods, the drawing line is a 
a. brush c. belt 
b. stroke d. draw 
Exercises 
=) Programming Exercises 
1. Write an application that extends JFrame and that displays a phrase in every font 
size from 6 through 20. Save the file as JFontSizes.java. 
2. a. Write an application that extends JFrame and that displays a phrase in one color 








the first time the user clicks a JButton. The next time the user clicks the 
JButton, make the first phrase seem to disappear. (Hint: Redraw it using the 
background color.) At the same time, draw the phrase again in a different color, 
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Exercises 


size, and horizontal position. The third click should change the color, size, and 
position of the phrase again. Save the file as JChangeSizeAndColor.java. 


b. Modify the JChangeSizeAndColor application so that it continuously changes 
the size, color, and location of a phrase as long as the user continues to click the 
button. Save the application as JChangeSizeAndColor2.java. 937 








3. Write an application that extends JFrame and that displays a phrase upside down 
when the user clicks a button. The phrase is displayed normally when the user 
clicks the button again. Save the application as JUpsideDown.java. 


4, Write an application that extends JFrame and that displays eight nested rectangles, 
like those in Figure 16-38. You may use only one drawRect() statement in the 
program. (Hint: Use it in a loop.) Save the file as JNestedBoxes.java. 











Figure 16-38 Output of the JNestedBoxes program 







5. Write an application that extends JFrame and that displays 15 nested circles, like 
those in Figure 16-39. You may use only one drawOval() statement in the 
program. Save the file as JNestedCircles.java. 
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Figure 16-39 Output of the JNestedCircles program 


6. Write an application that extends JFrame and that displays diagonal lines in a 
square, like those in Figure 16-40. Save the file as JDiagonalLines.java. 











Figure 16-40 Output of the JDiagonalLines program 
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11. 


12. 


13. 
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a. Write an application that extends JFrame and that displays a yellow smiling 
face on the screen. Save the file as JSmileFace.java. 


b. Add a JButton to the JSmileFace program so the smile changes to a frown 
when the user clicks the JButton. Save the file as JSmileFace2.java. 


a. Use polygons and lines to create a graphics image that looks like a fireworks 939 
display. Write an application that extends JFrame and that displays the 
fireworks. Save the file as JFireworks.java. 








b. Add a JButton to the JFireworks program. Do not show the fireworks until 
the user clicks the JButton. Save the file as JFireworks2.java. 


a. Write an application that extends JFrame and that displays your name. 
Place boxes around your name at intervals of 10, 20, 30, and 40 pixels. Save the 
file as JBorders.java. 


b. Modify the JBorders program so that each of the four borders is a different 
color. Save the file as JBorders2.java. 


Search the Web for the approximate value of the U.S. dollar in other currencies. 
Write an application that extends JFrame and that prompts the user to enter a 
value in U.S. dollars. Use Graphics2D methods to display the dollar amount as well 
as the equivalent values of two other currencies of your choice. Save the file as 
JCurrencies.java. 


Write an application that extends JFrame and that uses the Graphics2D environ- 
ment to create a GeneralPath object. Use the GeneralPath object to create the 
outline of your favorite state. Display the state name at the approximate center of 
the state boundaries. Save the file as JFavoriteState.java. 


Write an application that extends JFrame and that draws a realistic-looking stop 
sign. Save the file as JStopSign.java. 


Write an application that displays a JFrame that does the following: 
e Turns yellow when the user’s mouse enters the frame 
e Turns black when the user’s mouse exits the frame 


e Displays a larger circle at a point near where the user left-clicks 






e Displays a smaller circle at a point near where the user right-clicks 


At most, one circle should appear on the surface of the frame at a time. Save the 
file as JMouseFrame.java. 


CHAPTER 16 Graphics 


e Debugging Exercises 


1. Each of the following files in the Chapter16 folder of your downloadable student 

files has syntax and/or logic errors. In each case, determine the problem and fix 
940 the program. After you correct the errors, save each file using the same filename 
preceded with Fix. For example, DebugSixteen1.java will become 
FixDebugSixteen1 java. 





a. DebugSixteenl java c. DebugSixteen3.java 
b. DebugSixteen2.java d. DebugSixteen4.java 


BS Game Zone 


a. In Chapter 9, you created a Tic Tac Toe game in which you used a 2D array of 
characters to hold Xs and Os for a player and the computer. Now create a 
JFrame that uses an array of nine JButtons to represent the Tic Tac Toe grid. 
When the user clicks a JButton that has not already been taken, place an X on 
the button and then allow the computer to place an O on a different button. 
Announce the winner when either the computer or the player achieves three 
marks in sequence, or announce that the game was a tie. Figure 16-41 shows a 
typical game in progress and after the player has won. Save the game as 
JTicTacToe.java. 


Tic Tac Toe Tic Tac Toe 
Choose one button Choose one button 
x Oo x || 










































































Figure 16-41 Typical execution of the JTicTacToe program 
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b. Adda graphic that displays a large letter representing the winning player of the 
game in Game Zone exercise la. Draw a large X, O, or, in case of a tie, an 
overlapping X and O in different colors. Save the game as JTicTacToe2.java. 


2. Create an application that plays a card game named Lucky Seven. In real life, the 

game can be played with seven cards, each containing a number from 1 through 7, 941 
that are shuffled and dealt number-side down. To start the game, a player turns 
over any card. The exposed number on the card determines the position (reading 
from left to right) of the next card that must be turned over. For example, if the 
player turns over the first card and its number is 7, the next card turned must be 
the seventh card (counting from left to right). If the player turns over a card whose 
number denotes a position that was already turned, the player loses the game. If the 
player succeeds in turning over all seven cards, the player wins. 








Instead of cards, you will use seven buttons labeled 1 through 7 from left to right. 
Randomly associate one of the seven values 1 through 7 with each button. (In other 
words, the associated value might or might not be equivalent to the button’s 
labeled value.) When the player clicks a button, reveal the associated hidden 
value. If the value represents the position of a button already clicked, the player 
loses. If the revealed number represents an available button, force the user to click 
it; that is, do not take any action until the user clicks the correct button. After a 
player clicks a button, remove the button from play. (After you remove a button, 
you can call repaint() to ensure that the image of the button is removed.) 


For example, a player might click Button 7, revealing a 4. Then the player clicks 
Button 4, revealing a 2. Then the player clicks Button 2, revealing a 7. The player 
loses because Button 7 was already used. Save the game as JLuckySeven.java. 


3. a. In Chapters 7 and 8, you created a game named Secret Phrase in which the user 
guesses a randomly selected secret phrase by entering one letter at a time. Now 
create a GUI application that plays the game, allowing users to choose a letter 
by selecting one of 26 buttons. (Hint: Consider creating an array of buttons 
rather than 26 individually named buttons.) 


Disable a letter button once it has been guessed, and after the puzzle is 
complete, disable all the letters. Figure 16-42 shows a typical execution (1) after 
the user has guessed an A, which is in the phrase; (2) after the user has guessed 
a D, which is not in the phrase; and (3) after the user has completed the puzzle. 
Save the file as JSecretPhrase.java. 
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Secret Phrase Game 
Play our game - guess the phrase _ Enter one letter 


REE J ces Correct! Enter oneletter A c 


Le Ibs Joe Jl LL 


942 















































Secret Phrase Game 


Play our game - guess the phrase Enter one letter 


RRR AEX sorry - not in the phrase: D [a | B Leal 
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Secret Phrase Game 


Play our game - guess the phrase _ Enter one letter 


CHICAGO Congratulations! A B c 
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Figure 16-42 Typical execution of the JSecretPhrase program 
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b. Make the JSecretPhrase game more like the traditional letter-guessing game 
Hangman by drawing a “hanged” person piece by piece with each missed letter. 
For example, when the user chooses a correct letter, place it in the appropriate 
position or positions in the phrase, but the first time the user chooses a letter 
that is not in the target phrase, draw a head for the “hanged” man. The second 
time the user makes an incorrect guess, add a torso. Continue with arms and 
legs. If the complete body is drawn before the user has guessed all the letters in 
the phrase, display a message indicating that the player has lost the game. If the 
user completes the phrase before all the body parts are drawn, display a 
message that the player has won. Save the game as JSecretPhrase2.java. 


Case Problems 


1. In Chapters 14 and 15, you developed an interactive GUI application for Carly’s 
Catering. Now, design a JPanel that uses graphics to display a logo for the 
company, and modify the GUI application to include it. Save the JPanel class as 
JCarlysLogoPanel.java, and save the GUI application as JCarlysCatering java. 


2. In Chapters 14 and 15, you developed an interactive GUI application for Sammy’s 
Seashore Rentals. Now, design a JPanel that uses graphics to display a logo for 
the company, and modify the GUI application to include it. Save the JPanel 
class as JsammysLogoPanel.java, and save the GUI application as 
JSammysSeashore.java. 
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Applets, Images, and 
Sound 


In this chapter, you will: 


Learn about applets 


(©) 


Write an HTML document to host an applet 
Use the initQ method 
Work with JApp let components 


(ORT ORTO) 


Understand the JApplet life cycle 


(©) 


Understand multimedia and use images 
Add sound to JApplets 


(ORO) 
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Introducing Applets 


An applet is a program that is called within another application—often a Web browser. It can 
contain any number of components, such as buttons, text fields, and pictures, and it can 
respond to user-initiated events, such as mouse clicks or keyboard presses. Many of an 
applet’s behaviors come from methods that reside in a Java class named JApplet—the 
programmer can create additional behaviors. The name applet means “little application.” An 
applet is “little” in that it is not a full-blown program; it relies on other programs to execute it. 


A Java applet is like a Java application in several ways: 
e You save both applets and applications with a java file extension. 


e You compile both applets and applications into bytecode using the javac command, and 
the bytecode is stored in a file with a .class file extension. 


e Both applets and applications can contain any number of methods you define and any 
number of variables and constants. Both can contain decisions, loops, arrays, and all the 
other language elements you have learned about in Java. 


e Both can (and applets almost always do) contain GUI elements such as buttons and labels, 
and event listeners that respond to user-initiated actions. 


An applet also is different from an application in several ways: 
e Unlike applications, applets descend from the JApplet class. 


e Unlike applications, applets run from another application. You do not use the java 
command to execute an applet. 


e Unlike applications, applets do not contain a main() method. In this chapter, you will 
learn about the methods every applet contains. 





e Unlike an application that uses a JFrame, you do not set a default close operation for 
a JApplet. 


e Applets cannot delete, read, or create files on the user’s system. 


e Applets cannot run any other program on the user’s system. 


Understanding the JApplet Class 


JApplet is a Swing class from which you can inherit. A JApplet is a Component, and it is also a 
Container. Figure 17-1 shows the relationship of JApplet to its ancestors. When you create a 
JApplet, you gain access to over 200 methods through inheritance. 
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java.lang.Object 


+--java.awt.Component 


+--java.awt.Container 
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+--java.awt. Panel 


+--java.applet.Applet 


+--javax.swing.JApplet 











Figure 17-1 Inheritance hierarchy of the JApplet class 


You can import the JApplet class to a program by using one of the following statements: 


import javax.swing.JApplet; 
import javax.swing.*; 


Running an Applet 


To view an applet, it must be called from another document; frequently the document is 
written in HTML. HTML, or Hypertext Markup Language, is a simple language used to create 
Web pages for the Internet. HTML contains many commands that allow you to format text 
on a Web page, import graphic images, and link your page to other Web pages. You run 
applets within a page on the Internet, an intranet, or a local computer. 


minor, although XHTML is stricter. Most Web developers are continuing to use HTML until XHTML matures 
and some compatibility issues are resolved. You can find more information and tutorials on both HTML and 
XHTML at www.w3schools.com. 


Q The current version of HTML is Extensible Hypertext Markup Language (XHTML). The differences are 


You can run an applet in one of two ways: 


e You can run an applet in a Web browser, such as Internet Explorer, Firefox, Opera, or 
Safari. To do so, you open the applet-hosting HTML document in the browser. For 
example, in Internet Explorer, you click File on the menu bar, click Open, and type 
the complete path for the HTML document that you created. After you press Enter, 
the applet appears on your screen. The applet can be run within a page on the Internet 
or an intranet, but you do not have to connect to the Internet to run an applet in your 
browser—you can simply use the browser locally. 


e You can also view your applet on a local computer by using the Applet Viewer, which is a 
program that comes with the Java Development Kit (JDK) that provides a convenient 
environment in which to test your applets. To use the Applet Viewer, type the 
appletviewer command at the command line, followed by the full HTML filename, 
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including the extension. When you press Enter, the Applet Viewer window opens and 
displays the applet. 


DOS and Windows, filename extensions were not allowed to be more than three characters. Current 
Web browsers and servers accept files with .htm and .html extensions. Examples in this book use the 
four-character .html extension. 


Q When you save an HTML file, you can use .html or .htm as a file extension. In some older versions of 
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Introducing Applets 


1. An applet can contain any number of components, such as buttons, text fields, 
and pictures, and can respond to user-initiated events, such as mouse clicks or 
keyboard presses. 


2. Applets and applications are similar in that both have .java file extensions 
and you compile both with the javac command. 


3. Applets and applications are different in that applets do not use loops and 
arrays. 


"ener ul SJonNASUOD aZensue] ayy je asn sjajddy ‘e# si JuaWaTeys asjey aU] 


Writing an HTML Document to Host an Applet 
When you create an applet, you do the following: 


e Write the applet in Java and save it with a java file extension, just as when you write a Java 
application. 


e Compile the applet into bytecode using the javac command, just as when you write a Java 
application. 


e Write an HTML document that includes a statement to call your compiled Java class. 


e Load the HTML document into a Web browser (such as Internet Explorer) or run the 
Applet Viewer program, which in turn uses the HTML document. 


Java in general and applets in particular are popular topics among programmers, partly 
because users can execute applets using a Web browser on the Internet. A Web browser is 
a program that allows you to display HTML documents on your computer screen. Web 
documents often contain Java applets. 
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A malicious programmer might try to include code that contains a virus, reads data from your files, or 
performs other unwanted tasks. Therefore, applet code runs in a constrained area called a sandbox. 
A sandbox is a safe area in which a program can run, much like a real sandbox is an area in a yard 
where children can play safely. 


Q Because applets are sent over the Internet and run from other applications, applet code is not trusted. 
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Fortunately, to run a Java applet, you don’t need to learn much HTML; you need to learn only 
two pairs of HTML commands, called tags. The tag that begins every HTML document is 
<htm1>. Like all tags, this opening tag is surrounded by angle brackets. The htm] within the 
tag is an HTML keyword that specifies that an HTML document follows the keyword. The 
tag that ends every HTML document is </htm1>. The preceding slash indicates that the tag is 
a closing tag. The following is the simplest HTML document you can write: 


<html> 
</html> 


uses the all-lowercase convention when displaying HTML code. With the growing importance of XML and 
XHTML, many programmers recommend putting all HTML tags in lowercase because XML and XHTML are 
case sensitive, even though HTML is not. 


Q Unlike Java, HTML is not case sensitive, so you can use <HTML> in place of <htm1>. However, this book 


The simple HTML document, containing just the pair of htm] tags, begins and ends and does 
nothing in between; you can create an analogous situation in a Java method by typing an 
opening curly brace and following it immediately with the closing curly brace. HTML 
documents generally contain more statements. For example, to run an applet from an 
HTML document, you add an <object> and </object> tag pair. Usually, you place three 
attributes within the <object> tag: code, width, and height. Tag attributes, sometimes 
referred to as arguments, promote activity or describe the features of the tag; with arguments, 
the HTML tag can do something in a certain way. Note the following example: 


<object code = "AClass.class" width = 300 height = 200> </object> 


The three object tag attributes in the previous example are described with their 
corresponding arguments in the following list: 


e code = is followed by the name of the compiled applet you are calling. 
e width = is followed by the width of the applet on the screen. 
e height = is followed by the height of the applet on the screen. 


The name of the applet you call must be a compiled Java applet (with a .class file extension). 
The width and height of an applet are measured in pixels. For monitors that display 1024 
pixels horizontally and 768 pixels vertically, a statement such as width = 512 height = 384 
creates an applet that occupies approximately one-fourth of most screens (half the height and 
half the width). 


When you assign a height and width to an applet, keep in mind that a browser's menu bar and screen 
Y elements (such as the toolbar and the scroll bars) take up some of the screen viewing area for an applet. 
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applet host documents. However, the World Wide Web Consortium recommends using object rather 
than app1et because it is more general, and it includes new and future media types in addition to applets. 
For more information, including definitions of and recommendations for using all the other HTML tags, visit 
Wwww.w3.org. 


Q Instead of the <object> and </object> tag pair, you can use <app1et> and </applet> in your HTML 
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Figure 17-2 shows an HTML file that could be used to run a JApplet named JHe11o. 
The applet will be 450 pixels wide by 150 pixels tall. 


<htm1> 
<object code = "JHello.class" width = 450 height = 150> 


</object> 
</html> 





Figure 17-2 The TestJHello.html file 


In Figure 17-2, the JHello.class file resides in the same folder as the HTML file, so no path is 
necessary in the object code statement. Later in this chapter, you will learn how to create the 
JHe11o class. 





Writing an HTML Document to Host an Applet 


1. You must run applets within a Web page. 


2. To view an applet, it must be called from another document, such as one 
written in HTML. 


3. All HTML tags are surrounded by angle brackets. 
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Using the initQ Method 


The JApplet class uses several methods that are invoked by a Web browser when the browser 
runs an applet. In a Java application, the main) method calls other methods that you write, 
but in contrast, an applet does not contain a main() method. With an applet, the browser or 
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Applet Viewer calls several methods automatically at different times. The following five 
methods are inherited from JApplet, are called automatically, and constitute the life cycle 
of an applet: 


e public void initQ 


e public void startQ) 951 








e public void paint() 
e public void stop() 
e public void destroy() 


You can override any of these methods within a JApplet that you write. If you fail to 
implement one or more of these methods, your JApplet will use the versions that belong to 
the parent JApplet class. To create a Java applet that does anything useful, you must code 
statements within at least one of these methods. 


For example, you can create a JApplet using only the init© method. The initQ© method is 
the first method called in any applet. You use it to perform initialization tasks, such as setting 
variables to initial values or placing applet components on the screen. In general, tasks that 
you would place in the constructor for a JFrame in an application are the same types of tasks 
you place in an init© method in a JApptlet. 


You must code the init() method’s header as follows: 
public void initQ) 


Figure 17-3 shows the JApplet that displays “Hello. Who are you?” in a JLabel on the screen. 
The default layout manager for a JApplet is BorderLayout, so when the JLabel is added to 
the applet without a specified region, the JLabel occupies the entire JApplet surface. 


import javax.swing.*; 
import java.awt.*; 
public class JHello extends JApplet 
{ 
JLabel greeting = new JLabelC"Hello. Who are you?"); 


public void initQ) 
{ 


} 


add(greeting) ; 





Figure 17-3 The JHello JApplet 


After you write this JApplet, you do the following: 
e Save this file as JHello.java, and compile it. 


e Run the Applet Viewer using the command appletviewer TestJHello.html and the 
saved file shown in Figure 17-2. 
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[ie aeeel 
| S| Applet Viewer: JHello.class ey 


952 ello. Who are you? 








Figure 17-4 Output of the JHello JApplet when run in the Applet Viewer 


Figure 17-4 shows how the applet appears on your screen. After you view a JApplet, you can 
click the close button on the Applet Viewer to end the application. Unlike a JFrame, you do 
not need to set a default close operation with a JApplet. 


ee 
Eu Watch the video Writing and Running an Applet. 





Using the init() Method 


1. InaJava applet, the main© method is the first to execute; it calls other methods 
that you write. 


2. The following five methods can automatically be called by every applet: initQO, 
startQ), paint, stopQ, and destroy(). 


3. You can create a JApplet using only the initQ method, which is the first 
method called in any applet. 
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\ You Do It 


Creating an HTML Document to Host an Applet 


In this section, you create a simple HTML document that you will use to display the 
applet you will create in the next section. You will name the applet JGreet, and it will 
occupy a screen area of 450 by 100 pixels. 
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1. Open a new file in your text editor. Type the opening HTML tag: 
<htm1> 


2. On the next line, type the opening object tag that contains the applet’s name 
and dimensions: 


<object code = "JGreet.class" width = 450 height = 200> 
3. On the next line, type the applet’s closing tag: 

</object> 
4. On the next line, type the closing HTML tag: 

</html> 


5. Save the file as TestJGreet.html. Just as when you create a Java application, 
be certain that you save the file as text only and use an .html extension. 
The .html file extension is required and makes the file easy to identify as 
an HTML file. 


Creating and Running a JApplet 
Next, you create the JGreet applet for which you prepared the HTML document. 


1. Open a new text file in your text editor. Enter the following import statements 
you need for the JApplet. You need the javax. swing package because it 
defines JApplet, and you need the java.awt package because it defines 
Container. 
import javax.swing.*; 
import java.awt.*; 

2. Next, enter the JGreet JApplet. It contains a Container that holds a JLabel. 
The init© method adds the JLabel to the Container. 


(continues) 
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(continued) 


public class JGreet extends JApplet 
{ 
Container con = getContentPane() ; 
JLabel greeting = new JLabel ("Greetings!"); 
public void initQ 
{ 


} 


con.add(greeting) ; 


} 


Save the file as JGreet.java. Then compile the class. If necessary, correct any 
errors and compile again. 


At the command line, type appletviewer TestJGreet.html, and then press 
Enter. The applet appears on your screen, as shown in Figure 17-5. 


| 5| Applet Viewer: JGreet.class 
Applet 





reetings! 





Applet started. 





Figure 17-5 Execution of the JGreet JApplet 


Use the mouse pointer to drag any corner of the Applet Viewer window to resize 
it. Notice that if you increase or decrease the window’s height, the window is 
redrawn on the screen and the JLabel is automatically repositioned to remain 
centered within the window. If you make the window narrower by dragging its 
right border to the left, the JLabel eventually becomes partially obscured when 
the window becomes too narrow for the display. 


greeting, make the string in the label longer—for example, “Greetings to you and all your family!” 
Recompile the applet and then use the app1etviewer command to display the HTML document 
again. The string displayed will be long enough for you to observe the effects when you narrow the 
width of the window. 


Q If your operating system does not allow you to make the window narrow enough to obscure part of the 


Close the Applet Viewer by clicking the Close button in the upper-right corner of 
the window. 


(continues) 
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(continued) 
Running a JApp7et in Your Web Browser 
1. Open any Web browser, such as Internet Explorer. You do not have to connect to 955 


the Internet; you will use the browser locally. (If you do not have a Web browser 
installed on your computer, skip to the end of Step 3.) 








2. Click File on the menu bar, click Open, type the complete path for the 
HTML document that you created to access JGreet.class (for example, 
C:\Java\Chapter17\TestJGreet.html), and then press Enter. Instead of 
typing the filename, you can click the Browse button, browse to the file 
location, and then click OK. You might have to agree to several security 
messages before you can view the applet. The applet should appear in the 
browser on your screen. If you receive an error message, verify that the path 
and spelling of the HTML file are correct. 


3. Close the browser. 


~, Some applets might not work correctly with your browser. Java was designed with a number of security 

GY features so that when an applet is displayed on the Internet, the applet cannot perform malicious tasks, 

és such as deleting a file from your hard drive. If an applet does nothing to compromise security, testing it 
using the Web browser or the app 1etviewer command achieves the same results. For now, you can 
get your applets to perform better by using the Applet Viewer window because the output does not 
depend on the browser type or version. 


Working with JApplet Components 


The output in Figures 17-4 and 17-5 is not very attractive or interesting. Fortunately, all the 
techniques that you used with JFrames in Chapters 14, 15, and 16 can also be used with 
JApplets. For example, you can do the following: 


e Change the font and color of labels 
e Use layout managers 

e Add multiple GUI components 

e Change the background color 

e Add listeners for user events 

e Add images and sounds 


For example, Figure 17-6 shows how you can write a JApplet that displays a prompt, allows 
the user to enter text and press a button, and displays output. The JApplet also uses color 
and interesting fonts. The initQ method sets up the applet surface and enables both the 
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button and text box to generate events to which the JApplet can respond. The setLayout () 
method is used to set the content pane’s layout manager to FlowLayout; without the 
setLayout() statement, the content pane would use the default BorderLayout. 
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import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
import java.awt.Color; 
public class JHello2 extends JApplet implements ActionListener 
{ 
JLabel greeting = new JLabelC"Hello. Who are you?"); 
Font fontl = new Font("Teen", Font.BOLD, 36); 
Font font2 = new Font("Teen", Font.ITALIC, 48); 
JTextField answer = new JTextField(10); 
JButton pressMe = new JButton("Press me"); 
JLabel personalGreeting = new JLabel(" "); 
Container con = getContentPane() ; 
public void initQ 
af 
greeting.setFont(font1) ; 
personalGreeting.setFont(font2) ; 
con.add(greeting) ; 
con.add(answer) ; 
con.add(pressMe) ; 
con.setLayout(new FlowLayout()); 
con.setBackground(Color. YELLOW) ; 
pressMe.addActionListener(this) ; 
answer.addActionListener(this) ; 
} 
public void actionPerformed(ActionEvent e) 
{ 
String name = answer.getText(); 
con. remove (greeting) ; 
con.remove(pressMe) ; 
con. remove (answer) ; 
personalGreeting.setTextC"Hello, "+ name +"! "); 
con.add(personalGreeting) ; 
con.setBackground(Color. PINK) ; 
validate(); 





Figure 17-6 The JHel1o2 class that adds a JLabel when the user clicks the JButton 


The code in the actionPerformed() method in the JHe11o2 class shows that after the user 
clicks the button, the name is retrieved from the text field; the label, button, and text field are 
removed from the applet surface; and the setText() method sets the JLabel text for 

personalGreeting to "Hello, " + name + "! ". Then the personal greeting is added to the 
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JApplet’s Container, and the background color is changed. You learned about all of the same 
methods when you studied JFrames in Chapters 14 and 15. Figure 17-7 shows a typical 
execution. 


|S) Applet Viewer: JHello2.class 957 











Hello. Who are you? 


Amanda | Press me 





|S) Applet Viewer: JHello2.class 





Hello, AManda! 





Figure 17-7 Typical execution of the JHello2 JApplet 


In the actionPerformed() method in Figure 17-6, the final statement following the addition 
of the JLabel is validate(). As you learned in Chapter 15, invoking the validate() method 
after adding one or more JComponents to an applet ensures that the Components draw 
themselves on the screen. It isn’t necessary to call the validate() method every time you 
add a JComponent to a JApplet. For example, when you add components in the initQ or 
start() methods, you do not have to call validate(). When you add components in 
other methods (frequently event-handling methods), you must call validateQ. 


Q The validateQ) method is complex. Even the online Java documentation refers to its performance as 
“voodoo.” 


ee 
= Watch the video Working with JApplet Components. 
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Working with JApplet Components 


1. Inanapplet, you can change fonts and colors of GUI components just as you can 
in an application. 

2. JApplets can contain an actionPerformed() method to respond to mouse 
clicks. 


3. Invoking the validate() method in an applet allows it to pass security 
restrictions. 
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«a You Do It 


Creating a More Complicated JApplet 


Next, you change the font of the text in your JGreet applet, add components, and 
make other changes to make a more complicated and useful JApplet. 


1. Open the JGreet.java file in your text editor, and change the class name to 
JGreet2. Immediately save the file using the filename JGreet2.java. 


2. After the declaration of the greeting JLabel, declare a Font object named 
bigFont by typing the following: 
Font bigFont = new Font("Times Roman", Font.ITALIC, 24); 


3. Within the init©O method, set the greeting font to bigFont by typing the 
following: 
greeting.setFont(bigFont) ; 


4. Along with the other declarations, declare two JLabels, two empty 
JTextFields, and a JButton with the label View Greeting by typing the 
following: 


(continues) 
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(continued) 


JLabel firstLabel = new JLabel("'Please enter your first name:"); 
JLabel lastLabel = new JLabel("'Please enter your last name:"); 
JTextField firstField = new JTextField("",10); 959 
JTextField lastField = new JTextField("",10); 
JButton viewButton = new JButton("View Greeting"); 








5. Set the new layout manager to a flow layout with the following statement: 
FlowLayout flow = new FlowLayout() ; 

6. Within the initO method, set a layout manager as follows: 
con. setLayout (flow) ; 

7. Add all the newly created components to the applet by typing the following: 


con.add(firstLabel); 
con.add(firstField); 
con.add(lastLabel) ; 
con.add(lastField); 
con.add(viewButton) ; 


8. On the next line, request focus for the first-name text field by typing: 
firstField.requestFocus(); 
9. Save the file and compile it. 


10. Open the TestJGreet.html document you created earlier, and change the 
class name in the object code statement to JGreet2.class. Save the file as 
TestJGreet2.html. Execute the appletviewer TestJGreet2.html command. 
The output is shown in Figure 17-8. Confirm that you can type characters into 
the JTextFields and that you can click the JButton using the mouse. You 
haven't coded any action to take place as a result of a JButton click yet, but 
the components should function. 


Applet 





Greetings! Please enter your first name: 














Please enter your last name: View Greeting 














Figure 17-8 The JGreet2 JApplet 
11. Close the Applet Viewer window. 
(continues) 
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(continued) 
Making the JAppTet’s Button Respond to Events 


Next, you make your applet an event-driven program by adding functionality to the 
960 applet. When the user enters a name and clicks the JButton, the JApplet displays a 
personalized greeting. 





1. Open the JGreet2.java file in your text editor, and change the class name to 
JGreet3. Immediately save the file as JGreet3.java. 


2. Adda third import statement to your program by typing the following: 
import java.awt.event.*; 

3. Add the following phrase to the class header: 
implements ActionListener 


4. Prepare your JApplet for JButton-sourced events by typing the following 
statement within the init© method: 


viewButton.addActionListener(this) ; 


5. Following the init© method, add the following actionPerformedQ method. 
In the method, declare two Strings—one to hold the user’s first name and 
another for the last name—and then use the getText() method on the 
JTextFields to retrieve values for these Strings. Using the Strings, display 
a personalized question for the user. 


public void actionPerformed(ActionEvent thisEvent) 
{ 
String firstName = firstField.getTextQ); 
String lastName = lastField.getTextQ); 
greeting.setText("How are you, " 
lastName + "?"); 


+ firstName + + 


} 


6. Save the file and compile the program. Edit the file TestJGreet2.html to 
change the class reference to JGreet3.class, and then save the file as 
TestJGreet3.html. Run the applet using the appletviewer 
TestJGreet3.html command. 


7. Type your name in the JTextFields, and then click the View Greeting button. 
The personalized message should appear, similar to the one in Figure 17-9. 


(continues) 
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(continued) 


Applet 


How are you, Wendy Carpenter? 961 








Please enter your first name: |VWendy 
Please enter your last name: |Carpenter View Greeting 


Applet started. 

















Figure 17-9 Typical execution of the JGreet3 JApplet 


8. Drag the mouse to highlight the first or last name (or both) in the Applet 
Viewer window, and then type a different name. Click the View Greeting 
button. A greeting that uses the new name appears. 


9. Close the Applet Viewer window. 


Understanding the JApplet Life Cycle 


Applets are popular because they are easy to use in Web pages. Because applets execute in a 
browser, the JApplet class contains methods that are automatically called by the browser. 
You already are familiar with the paint() method. In Chapter 16 you learned that the system 
can request that a component’s contents be repainted or that the application can request 
repainting. The paint() method is always called after the init© and start() methods 
execute. It is also called if an applet needs repainting—if, for example, the user covers part of 
an applet with another open window and then uncovers it. The method works the same way 
with JApplets as with JFrames. The method header is as follows: 


public void paint(Graphics g) 


As you learned in Chapter 16, the paintQ method provides you with a Graphics object. 
If you override the paint© method in your applet, you can use the automatically provided 
Graphics object to draw shapes and strings. 


The other four methods that are automatically called in a JApplet are initQ, startQ, 
stop(), and destroy(Q). 


The init(Q Method 


You have already seen examples of JApplets that contain init() methods. When a Web page 
containing a JApplet is loaded in the browser, or when you run the appletviewer command 
within an HTML document that calls a JApplet, the applet’s initQ method executes. The 
init© method might be your version (if you have written one to override the version in the 
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parent class) or the automatically provided version. You should write your own initQ 
method when you have any initialization tasks to perform, such as setting up user interface 
components. 


962 The start() Method 


The start() method executes after the init() method, and it executes again every time the 
applet becomes active after it has been inactive. For example, if you run a JApplet using the 
appletviewer command and then minimize the Applet Viewer window, the JApplet 
becomes inactive. When you restore the window, the JApplet becomes active again. On the 
Internet, users can leave a Web page, visit another page, and then return to the first site. 
Again, the JApplet becomes inactive and then active. When you write your own start() 
method, you must include any actions you want your JApplet to take when a user revisits the 
JApplet. For example, you might want to resume some animation that you suspended when 
the user left the applet. 





The stopQ© Method 


When a user leaves a Web page (perhaps by minimizing a window or traveling to a different 
Web page), the stop() method is invoked. You override the existing empty stop() method 
only if you want to take some action when a JApplet is no longer visible. You usually don’t 
need to write your own stop() methods. 


The destroy() Method 


The destroy() method is called when the user closes the browser or Applet Viewer. Closing 
the browser or Applet Viewer releases any resources the JApplet might have allocated. As 
with the stop() method, you do not usually have to write your own destroy() methods. 


instructions to “suspend a thread,” or stop a chain of events that were started by a JApplet but are not 


Advanced Java programmers override the stop() and destroy() methods when they want to add 
GY yet completed. 


Every JApplet has the same life cycle outline, as shown in Figure 17-10. When the applet 
executes, the init© method runs, followed by the startQ method. If the user leaves the 
JApplet’s page, the stop() method executes. When the user returns, the start() method 
executes. The stop() and start() sequence might continue any number of times until the 
user closes the browser (or Applet Viewer), which invokes the destroy() method. 
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Figure 17-10 The JApp1et life cycle 


Understanding the JApplet Life Cycle 


1. The paint() method is always called after the initQ and start(Q methods 
execute or if an applet needs repainting. 

2. When a Web page containing a JApplet is loaded in the browser, the applet’s 
start) method is the first to execute. 


3. When a user leaves a Web page, the stop() method executes. 
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on You Do It 


Understanding the Applet Life Cycle 


To demonstrate the life cycle methods in action, you can write a JApplet that 
overrides all four methods: initQ, startQ, stop(), and destroy(). When you run 
this applet, you can observe the number of times each method executes. 


(continues) 
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(continued) 


1. Open a new text file in your text editor, and then type the following import 
statements: 


964 import javax.swing.*; 


import java.awt.*; 
import java.awt.event.*; 





2. Tomake the JApplet include a JButton that the user can click, and to implement 
an ActionListener, type the following header for a JLifeCycle applet and 
include an opening curly brace for the class: 


public class JLifeCycle extends JApplet implements ActionListener 


4 


3. Declare the following six JLabel objects, which display each of the six methods 
that execute during the lifetime of the applet: 


JLabel messageInit = new JLabel("init "); 
JLabel messageStart = new JLabel("start "); 
JLabel messageDisplay = new JLabel("display "); 
JLabel messageAction = new JLabel("action "); 
JLabel messageStop = new JLabel("stop "); 
JLabel messageDestroy = new JLabel ("destroy "); 


4. Declare a JButton by typing the following: 
JButton pressButton = new JButton('"Press"); 


5. Declare six integers that hold the number of occurrences of each of the six 
methods by typing the following code: 


int countInit, countStart, countDisplay, countAction, 
countStop, countDestroy; 


6. Start the init© method by adding a container and flow layout manager with the 
following statements: 


public void init() 

{ 
Container con = getContentPane() ; 
con.setLayout (new FlowLayout()); 


7. Add the following statements, which add 1 to countInit, place the components 
within the applet, and then call the display method: 


(continues) 
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(continued) 
++countInit; 


con.add(messageInit) ; 
con.add(messageStart) ; 
con.add(messageDisplay) ; 
con.add(messageAction) ; 965 
con.add(messageStop) ; 
con.add(messageDestroy) ; 
con.add(pressButton) ; 
pressButton.addActionListener (this) ; 
displayQ; 








} 


8. Add the following start(@ method, which adds 1 to countStart and calls 
display(): 


public void start() 
{ 
++countStart ; 
displayQ; 
} 


9. Add the following display© method, which adds 1 to countDisplay, displays 
the name of each of the six methods with the current count, and indicates how 
many times the method has executed: 


public void display() 

{ 
++countDisplay; 
messageInit.setTextC"init 
messageStart.setText("start 
messageDisplay.setText("display " + countDisplay); 
messageAction.setText("action " + countAction) ; 
messageStop.setText("stop " + countStop) ; 
messageDestroy.setText("destroy " + countDestroy) ; 


+ countInit); 
"+ countStart); 


5 


10. Add the following stopQ and destroy() methods. Each adds 1 to the 
appropriate counter and calls displayQ: 


public void stop() 


{ 
++countStop; 
displayQ; 
} 
public void destroyQ 
{ 
++countDestroy; 
displayQ; 
} 


(continues) 
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It. 


12. 


(continued) 


When the user clicks pressButton, the following actionPerformed( method 
executes; it adds 1 to countAction and displays it: 


public void actionPerformed(ActionEvent e) 


{ 


++countAction; 
displayQ; 


Add the closing curly brace for the class. Save the file as JLifeCycle.java. 
Compile the class. 


Take a moment to examine the code you created for the JLifeCcycle applet. 
Each method adds 1 to one of the six counters, but you never explicitly call 
any of the methods except display; each of the other methods is called 
automatically. 


Creating an HTML Document to Host the JApplet 


Next, you create an HTML document so you can test the JLifeCycle applet. 


ie 


Open a new file in your text editor, and then enter the following HTML code: 


<htm1> 

<object code = "JLifeCycle.class" width = 460 height = 60> 
</object> 

</html> 


Save the file as TestJLifeCycle.html. 
Run the HTML document using the following command: 
appletviewer TestJLifeCycle.html 


Figure 17-11 shows the output. When the applet begins, the init© method 
is called, so 1 is added to countInit. The init© method calls display, 
so 1 is added to countDisplay. Immediately after the init© method 
executes, the start() method is executed, and 1 is added to countStart. 
The startQ method calls displayQ, so 1 more is added to countDisplay. 
The first time you see the applet, countInit is 1, countStart is 1, and 
countDisplay Is 2. The methods actionPerformed(), stop(), and destroyQ 
have not yet been executed. 


(continues) 
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Applet started. 





Figure 17-11 The JLifeCycle JApplet when it first executes 


4. Click the Minimize button to minimize the Applet Viewer window, and then 
click the Taskbar button to restore it. The applet now looks like Figure 17-12. 
The init© method still has been called only once, but when you minimized the 
applet, the stop© method executed, and when you restored it, the startO 
method executed. Therefore, countStop is now 1 and countStart has increased 
to 2. In addition, because startQ and stop() call display, countDisplay Is 
increased by 2 and now holds the value 4. 


———— 
| S| Applet Viewer: JLifeCycle.class c= 


Applet 


init 1 start 2 display 4 action 0 stop 1 destroy 0 


Applet started. 





Figure 17-12 The JLifeCycle JApplet after minimizing and restoring 


5. Minimize and restore the Applet Viewer window again. Now, the stop©@ method 
has executed twice, the start) method has executed three times, and the 
display() method has executed a total of six times, as shown in Figure 17-13. 


Applet 


init 1 start 3 display 6 action 0 stop 2 destroy0 





Applet started. 


Figure 17-13. The JLifeCycle JApplet after minimizing and restoring twice 


(continues) 
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(continued) 


6. Click the Press button. The count for the actionPerformed() method is now 1, 
and actionPerformed() Calls display(), SO countDisplay is now 7, as shown in 
968 Figure 17-14. 





|| Applet Viewer: JlifeCycle.class 


Applet 














init 1 start 3 display 7 action 1 stop 2 destroy0 





Applet started. 


nn 





Figure 17-14 The JLifeCycle JApplet after minimizing and 
restoring twice, and then pressing the button 


7. Continue to minimize, maximize, and click the Press button. Note the changes 
that occur with each activity until you can correctly predict the outcome. Notice 
that the destroy( method is not executed until you close the applet, and then it 
is too late to observe an increase in countDestroy. 


8. Close the Applet Viewer. 


Understanding Multimedia and Using Images 


Multimedia describes the use of sound, images, graphics, and video in computer programs. 
Most computers that are sold today are “multimedia ready’—that is, they have CD-RW and 
DVD-RW drives, audio boards, and video capabilities. Java provides extensive multimedia 
tools, including the following: 


e Java programmers can use the Java 2D or the Java 3D Application Programming Interface 
(API) to create 3D graphics applications. 


e The Java Media Framework (JMF) API allows you to add audio and video media to an 
application. 


e Java Sound allows you to play, record, and modify audio files. 
e The Java Advanced Imaging API provides image-manipulation capabilities. 


e The Java Speech API allows a user to input speech commands and allows an application to 
produce speech output. 
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Adding Images to JApplets 


An image is a likeness of a person or thing. Images abound on the Internet in all shapes, 
colors, and sizes. Image formats supported by Java include: 


e Graphics Interchange Format (GIF), which can contain a maximum of 256 different colors 
969 








e Joint Photographic Experts Group (JPEG), which is commonly used to store photographs 
and is a more sophisticated way to represent a color image 


e Portable Network Graphics (PNG), which is more flexible than GIF and stores images in a 
lossless form. (PNG was originally designed to be a portable image storage form for 
computer-originated images.) Lossless data compression is a set of rules that allows an 
exact replica of data to be reconstructed from a compressed version. If you have ever 
worked with a .zip file, you have worked with lossless data compression. 


The Image class provides many of Java’s image capabilities; this class loads images that have 
been stored in one of the allowed Image formats. The Image class, which you can find in the 
java.awt package, is an abstract class. Recall that an abstract class is one from which you 
cannot create any objects, but which you can use as an interface or from which you can 
inherit. Because Image is abstract, you must create Image objects indirectly using the 
getImage() method. 


The getImage() method is used to load an Image into the named Image in the applet. One 
version of the getImage() method can take up to two arguments: a location where the image 
is stored and its filename. For example, you can create and load an Image named companyLogo 
with a statement such as the following: 


companyLogo = getImage(getCodeBase(), "logo.gif"); 
The getCodeBase() call returns the Uniform Resource Locator (URL) where the code is 


located. That is, it finds the directory from which the code is running. 


You can use the applet paint) method to display Image object images. The drawImage() 
method is a Graphics method that uses the following four arguments: 


e The first argument is a reference to the Image object in which the image is stored. 
e The second argument is the x-coordinate where the image appears on the applet. 
e The third argument is the y-coordinate where the image appears on the applet. 

e The fourth argument is a reference to an ImageObserver object. 


An ImageObserver object can be any object that implements the ImageObserver interface. 
Because the Component class implements the ImageObserver interface, all Components, 
including JApplets, inherit this implementation. Usually, the ImageObserver object is the 
object on which the image appears—in this case, the JApplet. Recall from Chapter 4 that the 
this reference refers to the current object using a method. Frequently, with the drawImage() 
method, you use the this reference to indicate that you want the Image drawn on the current 
JApplet. For example, the code to display the companyLogo image in the upper-left corner of 
the JApplet is as follows: 


g.drawImage(companyLogo, 0, 0, this); 
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You can use an overloaded version of the Graphics method drawImage()to output a scaled 
image. This method takes six arguments. Notice that the first three arguments are the same as 
those for the four-argument version of the drawImage() method. In the overloaded version: 


970 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





The first argument is a reference to the Image object in which the image is stored. 


The second and third arguments are the x- and y-coordinates where the image appears on 
the applet. 


The fourth and fifth arguments are the width and height of the scaled object. 


The sixth argument uses the this reference to implement the ImageObserver object. 


For example, the following code displays the companyLogo image at coordinates 0, 120 using 
the full width of the JApplet, but 100 pixels less than the height: 


g. 


drawImage(companyLogo, 0, 120, getWidth(), getHeight() - 100, this); 


Figure 17-15 shows a JApplet that draws an image twice. The JCompanyImage JApplet 
uses an image file named CompanyLogo.png, which holds a logo that is originally 287 pixels 
wide by 129 pixels high. Within the paint() method in the JAppTet, the image is drawn 
first in its “natural,” or original, size in the upper-left corner. Then it is redrawn lower at twice 
its original size. Figure 17-16 shows the contents of the HTML document that displays 

the applet; the output of the JCompanyImage applet is shown in Figure 17-17. 


import java.awt.*; 
import java.applet.*; 
import javax.swing.*; 
public class JCompanyImage extends JApplet 
{ 
Image companyLogo; 
final int WIDTH = 287; 
final int HEIGHT = 129; 
final int FACTOR = 2; 
public void init(Q) 
{ 


} 
public void paint(Graphics g) 
{ 


companyLogo = getImage(getCodeBase(), "“CompanyLogo.png"); 


super.paint(g); 

// Draw image at its natural size 

g.drawImage(companyLogo, 0, 0, this); 

// Draw the image scaled - twice as large 

g.drawImage(companyLogo, 0, HEIGHT, WIDTH * FACTOR, 
HEIGHT * FACTOR, this); 





Figure 17-15 The JCompanyImage JApplet 
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<html> 
<object code = "JCompanyImage.class" width = 600 height = 390> 


</object> 
</html> 
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Figure 17-16 The TestJCompanyImage HTML document 


Applet 


ABC Company 


ABC Company 


Applet started. 














Figure 17-17 Output of the JCompanyImage JApplet 


Q You can examine the CompanyLogo.png file in the Chapter 17 folder of your downloadable student files. 


Using ImageIcons 


You can also use the ImageIcon class to create images in your applications and applets. 

In general, working with the ImageIcon class is simpler than working with Image. You can 
use all the Image methods with an ImageIcon, plus many additional methods. Unlike with the 
Image class, you can create ImageIcon objects directly. Also, unlike with Images, you can 
place an ImageIcon on a Component, such as a JPanel, JLabel, or JButton, as well as on a 
JApplet or JFrame. For example, the following statements create a JButton that contains a 
picture of an arrow: 
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ImageIcon arrowPicture = new ImageIconC"arrow.gif"); 
JButton arrowButton = new JButton(arrowPicture) ; 


MediaTracker object to keep track of the image’s loading status. As you are aware if you have visited 

many Web pages, some images can require a good deal of time to load. To improve performance, the 

972 Image get() methods return immediately while the image continues to load, so that your application does 
not have to wait before performing other operations. 


Q Behind the scenes, each ImageIcon object uses an Image object to hold the image data and a 





You can also use the paintIcon() method to display ImageIcon images. This method 
requires four arguments: 


e The first argument is a reference to the Component on which the image appears—this in 
the following example. 


e The second argument is a reference to the Graphics object used to render the image—g 
in the following example. 


e The third and fourth arguments are the x- and y-coordinates for the upper-left corner of 
the image. 


The code to display the arrowPicture ImageIcon using the paintIcon() method is: 
arrowPicture.paintIcon(this, g, 180, 0); 


You can retrieve an ImageIcon’s width and height with methods named getIconwidthQ 
and getIconHeight(); each returns an integer. Figure 17-18 contains a JApplet that 
manipulates an ImageIcon’s width and height to achieve display effects. In the JBear 
JApplet, an ImageIcon is created using a .gif file. In the init© method, the width and 
height of the ImageIcon are stored in variables named width and height. In the 
actionPerformed() method, the width and height of the image are doubled with every 
button click. Figure 17-19 shows the JApplet when it starts, after the user has clicked the 
button once, and after the user has clicked the button twice. 
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import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 
public class JBear extends JApplet implements ActionListener 
{ 973 
private ImageIcon image = new ImageIcon("bear.gif"); 
private JButton closerButton = new JButtonC("Oh my!"); 
private int width, height; 
Container con = getContentPane(Q) ; 
public void initQ) 
{ 








con.setLayout(new FlowLayout()); 
closerButton.addActionListener(this) ; 
con.add(closerButton) ; 
width = image.getIconWidth(); 
height = image.getIconHeightQ; 

} 

public void actionPerformed(ActionEvent event) 


t 


width = width * 2; 
height = height * 2; 
repaint(); 


} 
public void paint(Graphics g) 
{ 
super.paint(g); 
g.drawImage(image.getImage(), 0, 0, width, height, this); 





Figure 17-18 The JBear JApplet 
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Applet started. Applet started. 











Applet started. 








Figure 17-19 Output of the JBear JApplet 


The first statement in the paint© method of the JBear applet passes the Graphics object to 
the JApplet class paint() method so that the applet surface is cleared. If you eliminate the 
call to super.paint( and then get a series of new bear images, all the previous versions 
remain on the screen “behind” the newest, larger one. 
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Notice that the drawImage() method call in the paintQ method uses image. getImage() as 
an argument. An ImageIcon cannot be drawn to scale, but an Image can, so you use the 
getImage() method to return a scalable Image reference for the ImageIcon object. 


Understanding Multimedia and Using Images 








1. Multimedia describes the use of sound, images, graphics, and video in computer 
programs; most computers that are sold today are “multimedia ready.” 


Image formats supported by Java include GIF, JPEG, and PNG. 


You can use the Picture Class to create images in your applications and applets. 


‘uoqange JO Lauegc & Se YONS ‘juUauoduo> e 
UO uodTebewy ue ade/d UdAd UD NOA ‘sjajdde pue suoedijdde snoA ul Saseul 
9}€319 0} SSe|9 uodTebewy JO abewy ay} SN ued NOA ‘EH SI JuaWa}e}s asje} ay] 


aN You Do It 


Displaying Images 
In the next steps, you add an animated image to an applet. 


1. Open a new file in your text editor, and then enter the first few lines of the 
JMonkey JApplet: 


import java.awt.*; 

import javax.swing.*; 

public class JMonkey extends JApplet 
{ 


2. Declare an ImageIcon and initialize it with the monkey.gif file that is stored in 
your downloadable student files. The file contains an animated image of a 
chimpanzee shaking its head from side to side. Declare variables to hold the 
width and height of the image, the content pane for the applet, and horizontal 
and vertical placement positions. 


private ImageIcon image = new ImageIcon("monkey.gif"); 
private int width, height; 
Container con = getContentPane() ; 
int x = 30; 
int y = 30; 
(continues) 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce 





earning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


CHAPTER 17 Applets, Images, and Sound 


(continued) 


3. Write the init© method to set the layout manager and get the width and height 
of the image. 


976 public void initO 


{ 





con.setLayout(new FlowLayout()); 

width = image.getIconWidth() ; 

height = image.getIconHeight() ; 
} 


4. The paint© method calls the parent’s method, then draws a string and draws 


the image 20 pixels lower. Add the method shown below, and then add a closing 
curly brace for the class. 


public void paint(Graphics g) 
{ 
super.paint(g) ; 
g-drawString("No, no, no", x, y); 
g-drawImage(image.getImage(), x, y + 20, 
width, height, this); 


} 
5. Save the file as JMonkey.java, and compile it. 
6. Write an HTML document to host the applet as follows: 


<html> 
<object code = "JMonkey.class" width = 200 height = 150> 
</object> 
</htm1> 

7. Save the HTML document as TestJMonkey.html. Run the applet. The output 
should look like Figure 17-20. On your screen, you will see the animated 
monkey move. 


|| Applet View... |=): 
Applet 










No, no, no 





Applet started. 








Figure 17-20 Execution of the JMonkey applet 
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Adding Sound to JApplets 


Java programs can play audio clips on computers that have speakers and a sound card (which 
includes most computers that are sold today). Java supports sound using methods from the 
Applet class, rather than JApplet. You can use these methods to retrieve and play sound files 
that use various sound formats. These formats include the Windows Wave file format (.wav), 977 
Sun Microsystems Audio file format (.au), and Music and Instrument Digital Interface file 
format (.midi or .mid). 








The simplest way to retrieve and play a sound is to use the play() method of the Applet 
class. The play( method retrieves and plays the sound as soon as possible after it is called. 
The play© method takes one of two forms: 


e playQ© with one argument—The argument is a URL object that loads and plays an audio 
clip when both the URL object and the audio clip are stored at the same URL. 


e playQ© with two arguments—The first argument is a URL object, and the second 
argument is a folder path name that loads and plays the audio file. The first argument is 
often a call to a getCodeBase() method or getDocumentBase() method to retrieve the 
URL object; the second argument is the name of the audio clip within the folder path that 
is stored at that URL. 


Used with the codebase attribute, which indicates the filename of the applet’s main class file, 
the getCodeBase() and getDocumentBase() methods direct the browser to look in a different 
folder for the applet and other files it uses. This is necessary when the desired files are in a 
different location than the Web page containing the applet. By calling getCodeBase() in an 
applet, you get a URL object that represents the folder in which the applet’s class file is stored. 
For example, the following statement retrieves and plays the tune.au sound file, which is 
stored in the same place as the applet: 


play(getCodeBase() ,"tune.au"); 


which the applet is stored. It is sometimes used instead of getCodeBase() as a matter of preference. 


The getDocumentBase() method returns an absolute URL naming the directory of the document in 
GY An applet is restricted to reading files only from the server that hosts it. 


To play a sound more than once, or to start or stop the sound, you must load the sound into 
an AudioClip object using the applet’s newAudioClip© method. AudioClip is part of the 
java.awt.Applet class and must be imported into your program. Like the play() method, 
the getAudioClip() method can take one or two arguments. The first argument (or only 
argument, if there is only one) is a URL argument that identifies the sound file; the second 
argument is a folder path reference needed for locating the file. 


The following statement loads the sound file from the previous example into the clip object: 
AudioClip aClip = new AudioClip(getCodeBase(), "audio/tune.au"); 


Here, the sound file reference indicates that the tune.au sound file is in the audio folder. 
After you have created an AudioClip object, you can use the play() method to call and 
play the sound, the stop© method to halt the playback, and the loop() method to play 
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the sound repeatedly. Multiple AudioClip items can play at the same time, and the 
resulting sound is mixed together to produce a composite. 
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Q In the next “You Do It” section, you will create a JApp1et that plays a sound. 


ee 
=. Watch the video Using Images and Sound in an Applet. 


on You Do It 


Adding Sound to JApplets 


Java programs can play audio clips on computers that have speakers and a 
sound card. 


Java supports sound using methods from the JAppTet class. 


Sound formats that applets can use include the Windows Wave file format (.wav), 
Sun Audio file format (.au), and Music and Instrument Digital Interface file format 
(.midi or .mid). 


‘(aa Lddyc Uey} JayIeJ) ssejo 
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Playing Sounds 


Next, you will use the loop@ method and an AudioC1ip to play a sound continually in 
an applet. You will also create and add a Graphics2D object. 


1. 


Open a new file in your text editor, and then enter the first few lines of the 
JSound JApplet: 


import java.awt.*; 
import java.applet.*; 
import javax.swing.*; 
public class JSound extends JApplet 
{ 
(continues) 
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(continued) 


2. Enter the following statement to declare an AudioClip object named sound: 


AudioClip sound; 
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3. Create the init© method and an AudioClip object to play the mysteryTune.au 
sound file by entering the following code: 


public void initQ) 
{ 


} 


You can find the mysteryTune.au file in the Chapter 17 folder of your 
downloadable student files. 


sound = getAudioCl ip(getCodeBase() , "mysteryTune. au") ; 


4. Create the following start© method. This method uses the 1loop( method to 
play the mysteryTune.au sound file continually: 


public void start() 
{ 


} 
5. Create the following stop(@ method to halt the mysteryTune.au sound file: 


sound. loopQ ; 


public void stop() 
{ 


} 


6. Create a Graphics object using paint(Graphics g), and then use a cast to 
change the graphics context to a Graphics2D object. Use the drawStringQ 
method to create a message that appears on the screen while the JApplet 
plays. Add a closing curly brace for the class. 


sound.stop(); 


public void paint(Graphics g) 


{ 
super.paint(g) ; 
Graphics2D g2D = (Graphics2D)g; 
g2D.drawString("Listen to the mystery tune ", 
10, 10); 
} 


} 
7. Save the file as JSound.java, and then compile it. 


8. Open a new file in your text editor, and then enter the following HTML document 
to test the JApplet: 


(continues) 
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(continued) 

<html> 

<object code = "JSound.class" width = 200 height = 50> 

</object> 

980 </htm1> 

9. Save the HTML document as TestJSound.html, and then run it using the 
appletviewer TestJSound.html command. The output should look like 
Figure 17-21. If speakers are installed on your system and they are on, you 
should also be able to hear sound playing continually. 


|| Applet View... Se 


Applet 
Listen to the mystery tune 


























Applet started. 





Figure 17-21 Output of the JSound JApplet 


Don't Do It 
e Don't forget a matching closing tag for every opening tag in an HTML document. 


e Don't forget to use the .class extension with the name of a JApplet you want to execute 
from an HTML document. 


e Don't add a mainQ method to a JApptTet; it will not execute automatically like it does 
in an application. 


e Don't try to execute an applet using the java command. An applet doesn’t contain 
amain() method and won't execute like an application. 


Key Terms 
An applet is a Java program that is called from another application. 
JApplet is a Swing class from which you can inherit to create your own applet. 


HTML, or Hypertext Markup Language, is a simple language used to create Web pages for 
the Internet. 


Extensible Hypertext Markup Language (XHTML) is an extension of HTML. 
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Chapter Summary iii 


Applet Viewer is a program that comes with the JDK that allows you to view applets without 
using a Web browser. 


The appletviewer command allows you to view an applet in a viewing program that comes 
with the JDK. 


A Web browser is a program that allows you to display HTML documents on your computer 981 
screen. 








A sandbox is a safe area in which a program can run without causing harm to other areas 
of a system. 


Tags are HTML commands. 
<htm1> is the tag that begins every HTML document. 
</htm1> is the tag that ends every HTML document. 


Tag attributes, sometimes referred to as arguments, promote activity or describe the features 
of an HTML tag. 


The init© method is the first method called in any applet. 


The start() method executes after the init( method, and it executes again every time the 
applet becomes active after it has been inactive. 


The stop() method is invoked in an applet when a user leaves a Web page (perhaps by 
minimizing a window or traveling to a different Web page). 


The destroy() method is called in an applet when the user closes the browser or Applet 
Viewer. 


Multimedia describes the use of sound, images, graphics, and video in computer programs. 
An image is a likeness of a person or thing. 


Lossless data compression is a set of rules that allows an exact replica of data to be 
reconstructed from a compressed version. 












Chapter Summary 


e An applet is a program that is called within another application—often a Web browser or 
a program called the Applet Viewer. Applets descend from the JApplet class and do not 
contain a main() method. 


e To view an applet, it must be called from another document written in Hypertext Markup 
Language (HTML), which is a simple language used to create Web pages for the Internet. 
When you create an applet, you write it in Java, save it with a java file extension, compile 
it, and write an HTML document that includes a statement to call your compiled Java 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. reserves the right to remove additi 


CHAPTER 17 Applets, Images, and Sound 


982 














class. You then load the HTML document into a Web browser or run the Applet Viewer 
program, which in turn uses the HTML document. 


With an applet, the browser calls several methods automatically at different times. The 
five methods that are included in every applet are initQ, startO, paintQ, stopQ, and 
destroy(). You can override any of those methods within a JApplet that you write. 


When you write a JApplet, you can add components, use fonts and colors, change the 
layout manager, and add event listeners, in much the same way you do in a JFrame. 


An applet’s paint© method is always called after the init© and startQ methods 
execute. It is also called if an applet needs repainting. When a Web page containing a 
JApplet is loaded in the browser, or when you run the appletviewer command within an 
HTML document that calls a JApplet, the applet’s initQ method executes. The start () 
method executes after the init() method, and it executes again every time the applet 
becomes active after it has been inactive. When a user leaves a Web page, the stop() 
method is invoked. The destroy() method is called when the user closes the browser or 
Applet Viewer. 


Multimedia describes the use of sound, images, graphics, and video in computer 
programs. Image formats supported by Java include Graphics Interchange Format (GIF), 
Joint Photographic Experts Group (JPEG), and Portable Network Graphics (PNG). The 
Image class provides many of Java’s image capabilities. You can also use the ImageIcon 
class to create images in your applications and applets. 


Java programs can play audio clips on computers that have speakers and a sound card. 
Supported sound formats include the Windows Wave file format (.wav), Sun Audio file 
format (.au), and Music and Instrument Digital Interface file format (.midi or .mid). The 
simplest way to retrieve and play a sound is to use the play© method of the AppTet class. 


Review Questions 


1. An applet is like a Java application in all of the following ways except 


a. you save it with a java file extension 
you compile it into bytecode, creating a file with a .class extension 


it can contain decisions, loops, arrays, and all the other language 
elements of Java 


d. it requires a mainQ) method 


2. Howisa JApplet different from an application that instantiates a JFrame? 
JFrames use graphics. 

JApplets run from another program. 

JFrames are larger than JApplets. 


ao F PS 


The user cannot close a JApplet; the program must issue a command to do so. 
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Review Questions iii 


3. A program that allows you to display HTML documents on your computer screen 


is a 
a. search engine c. browser 
b. compiler d. server 
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4, HTML contains commands that allow you to do all of the following 
except 

add JButtons to JApplets 

format text on a Web page 

import graphic images to a Web page 


ao Ff P 


link your page to other Web pages 


5. Pairs of HTML commands are called 
a. tickets c. tags 


b. labels d. keywords 


6. The name of any applet called using code within an HTML document must use 
the extension 


a. .exe c. java 
b. .code d._.class 

7. Which JApplet method can you override in your extended version? 
a. initO c. paint(d 


b. stopQ d. all of the above 


8. A JApplet is a(n) 











a. Container c. Object 
b. Component d. all of the above 
9. The first method called in any JApplet is the __________ method. 
a initQO c. begin( 
b. startQO d. mainQ) 


10. A JApplet’s init©O method is closest in purpose to a JFrame’s 


a. mainQ method 

b. actionPerformed() method 
c. startQ method 

d. constructor 
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11. 
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13. 


14. 


15. 


16. 








12. 


Ey, 


Which of the following JApplet methods is likely to execute the greatest number 
of times? 


a initQO c. destroy() 
b. startQ d. mainQ) 


The paint() method is automatically called 
before the initQ method 

after the startQ method 

from the actionPerformed() method 


oo fF 2 


never 


The start() method called in any JApplet is called 


as the first method when an applet starts 
when the user closes the browser 
when a user revisits an applet 


a0 Ff PS 


when a user leaves a Web page 


To respond to user events within a JApplet, you must 


a. prepare the applet to accept event messages 
b. import the java.applet.* package 

c. tell your applet how to respond to events 

d. accomplish both a and c 


When a user leaves a Web page, the JApplet method that executes is 


a. stopQO c killO 
b. destroyO d. exitQ 


describes the use of sound, images, graphics, and video in computer 


programs. 
a. Inheritance c. Art 
b. Multimedia d. Graphics 


Image formats supported by Java include all of the following except 


a. GIF c. MIDI 
b. JPEG d. PNG 
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18. Unlike using the Image class, objects of the ImageIcon class 


are harder to work with 
cannot be extended 
can be placed on components such as JButtons 
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cannot be created by calling the class constructor 985 








19. The Applet class method that retrieves sound is 


a. sound() c. record () 
b. musicQ) d. playQ 


20. The method that plays a sound repeatedly is 


a. playQO c. repeat() 
b. loopQ d. continue() 
Exercises 


=) Programming Exercises 


For each JApplet you create in the following exercises, create an HTML host document 
named Test plus the JApplet name. For example, the host document for the JRiddle.java file 
is named TestJRiddle.html. 


1. Create a JApplet with a JLabel that contains a riddle and a JButton. When the 
user clicks the button, display the answer in a large font on another JLabel. Save 
the file as JRiddle.java. 


2. a. Create a JApplet that asks a user to enter a password into a JTextField and to 
then press Enter. Compare the password to Rosebud; if it matches exactly, 
display “Access Granted”, If not, display “Access Denied”. Save the file as 
JPasswordA java. 








b. Modify the password applet in Exercise 2a to ignore differences in case between 
the typed password and Rosebud. Save the file as JPasswordB.java. 


c. Modify the password applet in Exercise 2b to compare the password to a list of 
five valid passwords: Rosebud, Redrum, Jason, Surrender, or Dorothy. Save the 
file as JPasswordC.java. 


3. Create a JApplet that contains a JLabel and JButton. When the user clicks the 
jButton, change the font typeface, style, and size on the JLabel. Save the file as 
JChangeFont.java. 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Ce: reserves the right to remove additi 


CHAPTER 17 Applets, Images, and Sound 


4. Create a JApplet that contains a JButton and a JTextField. When the user clicks the 
JButton, display “Today is ”, the date, and the time in the JTextField. Save the file as 
JDateAndTime.java. 


5. Create a JApplet that allows a user to type a product number in a JTextField. 
Compare the product number to an array of at least eight valid product numbers. If 
the typed number is valid, display a product description and price; otherwise, display 
an appropriate error message. Save the file as JProductFinder.java. 
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6. Create a JApplet that contains two parallel arrays with at least five friends’ names and 
phone numbers. Allow the user to enter either a name or phone number and to click a 
JButton to display the other. Include a JLabel to describe each JTextField. Save the 
file as JFriendsPhones.java. 


7. Create a JApplet that initially displays a single JButton. When the user clicks the 
JButton, display a JLabel that prompts the user to enter an integer, a JTextField 
into which the user can type the integer, and a second JButton that contains the text 
Double Me. When the user clicks the second button, the integer is doubled and the 
answer is displayed in the JTextField. Save the file as JDouble.java. 


8. Create a JApplet named JBMICalculator that allows the user to enter a height in 
inches and a weight in pounds. When the user clicks a JButton, the body mass index 
(BMI) is displayed. BMI is calculated by dividing weight by height squared and 
multiplying the result by 703. Save the file as JBMICalculator.java. 


9. Write a JApplet that uses the ImageIcon class to place ImageIcon objects on four 
JButtons. Download any free JPEG or GIF files from the Internet; if necessary, reduce 
the size of the images to approximately 30 by 30 pixels. Alternatively, you can use the 
four files named up.jpg, down.jpg, left.jpg, and right.jpg in your downloadable student 
files. Each time a JButton is clicked, display a different message below the JButtons. 
Save the file as JButtonIcons.java. 


10. Create a JApplet that paints an ImageIcon the first time its paint© method is called, 
and then randomly draws small filled ovals in the background color over the image 
each time a JButton is clicked. The resulting effect is that the image seems to be 
erased by an increasing number of small overlapping ovals. For example, if you place 
an ImageIcon at the coordinates contained in variables named startPosX and 
startPosy, you can create a series of 15-by-10 filled ovals placed randomly on the 
ImageIcon’s surface using the following for loop: 










for(int count = 0; count < 20; ++count) 


{ 
int x = Cint) (Math.random() * imageWidth) + startPosx; 
int y = Cint) (Math.random() * imageHeight) + startPosyY; 
g.fillOval(x, y, 10, 10); 

} 


Save the file as JEraseImage.java. 
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11. Create a JApplet for Business Associates, a consulting firm whose motto is “Let 
Business Associates take care of your business.” Include two JButtons: clicking one 
JButton plays the tune “Taking Care of Business” continuously, and clicking the 
other stops the music. You can find the business.mid file in your downloadable 


student files. Save the file as JBusiness.java. 
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12. Write an applet that prompts the user for a color name. If it is not red, white, 
or blue, throw an Exception. Otherwise, change the applet’s background color 
appropriately. Create an HTML document to host the JAppTet. Save the file as 
RWBApplet.java. 


13. Write a JApplet that uses a JPanel to show the messages “Mouse Entered Applet” 
and “Mouse Exited Applet” when the mouse enters and exits the applet. Also, when 
the mouse is clicked on the applet, a message “Mouse Clicked Here” should appear 
near the clicked location. Save the file as JMouse.java. 


% Debugging Exercises 


1. Each of the following files in the Chapter17 folder of your downloadable student 
files has syntax and/or logic errors. In each case, determine the problem and 
fix the program. After you correct the errors, save each file using the same 
filename preceded with Fix. For example, DebugSeventeen1.java will become 
FixDebugSeventeen1.java. You can test each applet with four downloadable student 
files named TestFixDebugSeventeen1.html through TestFixDebugSeventeen4.html. 


a. DebugSeventeenl.java c. DebugSeventeen3.java 
b. DebugSeventeen2.java d. DebugSeventeen4.java 
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Bs Game Zone 


In Chapter 2, you created a Mad Libs game in which the user entered several words 

out of context that were then inserted into a rhyme or story, producing humorous 
988 effects. Modify the game so it becomes an applet. In turn, prompt the user for each 
required word. After all the words are entered, display the completed rhyme or 
story. Figure 17-22 shows the first and last screens displayed during a typical 
execution. Save the applet as JMadLib.java. 








{S| Applet Viewer: JMadLib.c 
Applet 


Welcome to Mad Libs 
Enter a noun |book 


Completed Rhyme 
Mary had a little book 
Its dog was sleepy as snow 
And everywhere that Mary ate 
The book was sure to go 





Figure 17-22 First and last screens in a typical execution of the JMadLib applet 
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2. In Chapter 5, you created a Rock Paper Scissors game. Now create it as a JApplet 
in which the user can click one of three buttons labeled “Rock”, “Paper”, or 
“Scissors”. The computer’s choice is still randomly generated. Figure 17-23 shows 
a typical execution after the user has played a few games. Save the applet as 


JRockPaperScissors.java. 
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[S| Applet Viewer: JRockPaperscissors.ciass NN eal =) 


Rock, Paper, Scissors 
Choose one button 
------Results------ 


You picked paper ---- Computer picked rock 
Winner: you 
You: 2 Computer: 1 Ties: 1 


Applet started. 





Figure 17-23 Typical execution of the JRockPaperScissors applet 


3. In earlier chapters, you created and used a Card class in which each object represents 
a playing Card, and in Chapter 8 you constructed a deck of 52 unique Cards. Create a 
JApplet that uses such a deck. Start the player with a $10 stake. Randomly deal a card 
to the computer, and allow the player to make one of four bets: 


e $5 that the player’s card will be higher than the computer’s card 
e $10 that the player’s card will be higher than the computer’s card 
e $5 that the player’s card will be lower than the computer’s card 
e $10 that the player’s card will be lower than the computer’s card 


After the player makes a bet, deal the player’s card and add or subtract the correct 
amount from the player’s winnings based on the results. When the computer’s and 
player’s cards are the same value, the computer wins. The game ends when the first of 
these events happens: 







e The player goes broke (the winnings go to $0 or below). 
e The player wins $100. 


e All 52 cards are exhausted without a winner. 
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As shown in the game in progress in Figure 17-24, when the player is making a bet, 
enable four betting buttons. After the player makes a bet, disable the betting buttons 
while the player examines the outcome, and enable an OK button. When the player is 
ready to resume play and clicks OK, disable the OK button and, if the game isn’t over, 


enable the four betting buttons. Save the game as JCardBet.java. 
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| 4) Applet Viewer: JCardBet.class A 
Applet Applet 


** Bet the Card ™ ** Bet the Card ™* 
Computer: 7 of Diamonds | $5Higher Computer: 7 of Diamonds sioner | 





























$10 Higher $5 Lower $10 Lower [ $10 Higher} || $5 Lower ie $10 Lower | 








Starting with $10 | OK Your card: 9 of Hearts Your new totalis $15 





Figure 17-24 Typical execution of the JCardBet applet 


4. a. In Chapters 10 and 11, you created an Alien class and Martian and Jupiterian 
classes that descend from it. Add a draw() method for each child class. The 
draw() method accepts a Graphics object and x- and y- starting coordinates. 
The method draws the Aliens in any way you choose, using lines, ovals, 
rectangles, and so on. Using the drawString() method, include a description 
that names each drawing. Save the files as Martian.java and Jupiterian.java. 
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b. Create an applet that instantiates a Martian and a Jupiterian. In the applet’s 
paint() method, draw each type of Alien. Save the file as JDemoAliens.java. 
Figure 17-25 shows some sample Aliens, but your Aliens might look very 
different. 
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: — 
|4| Applet Viewer: JDemoAliensclass |) ‘= | © |e 


MM 


A Martian A Jupiterian 


Applet started. 





Figure 17-25 Some aliens 


c. Create an applet that contains an Alien Hunt game. Place eight numbered 
buttons in the applet. Randomly assign Martians to six of the buttons and 
Jupiterians to two. (Hint: You do not need to create an Alien array; you 
can simply create an array that randomly contains Os and Js, representing 
Martians and Jupiterians.) The object of the game is to find all the 
Martians before finding both Jupiterians. When a user clicks a button, display 
the Alien represented by the button. If the user clicks two Jupiterians 
before clicking six Martians, the player loses the game. When this happens, 
display two Jupiterians and a message telling the user that Earth has been 
destroyed. Disable any button after it has been selected. Save the game as 
JAlienHunt.java. 


5. a. In Chapter 4, you created a Die class that you can use to instantiate objects that 
hold one of six values. Create a GraphicDie class that descends from Die but 
adds a drawDie() method that draws a representation of the die on the screen. 
Design the method so it accepts a Graphics object as well as x- and y- 
coordinate positions where the drawing should be placed. Create the drawing of 
a Die based on its value and using the drawRect() and fi110val1() methods. 
Save the file as GraphicDie.java. 














b. Create a JGraphicDie JApplet that instantiates a GraphicDie object. In 
the JApplet’s paint() method, pass the method’s Graphics object and two 
values to the GraphicDie object’s drawDie() method. Save the file as 
JGraphicDie.java. 
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CHAPTER 17 Applets, Images, and Sound 


c. In Chapter 8, you created a FiveDice3 game in which a player’s random roll of 
five dice is compared to the computer’s roll and a winner is determined. Now 
create an applet that plays the game. At each roll, initiated by a player’s button 
click, display the player’s five dice and the computer’s five dice. Save the file as 
JFiveDice.java. Figure 17-26 shows a typical game. 
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Applet 





** Eive Dice ** --- Click the buttontoroll --- 


You have 4 of a kind You win 









































Figure 17-26 The JFiveDice applet 


Qe Case Problems 


1. Throughout this book you have created applications for Carly’s Catering. Now 
create a JApplet that advertises the business. Use at least one animation file and 
one sound file in your JApplet. Save the JApplet as JCarlys.java, and save 
the HTML host file as TestJCarlys.html. 


2. Throughout this book you have created applications for Sammy’s Seashore 
Rentals. Now create a JApplet that advertises the business. Use at least one 
animation file and one sound file in your JApplet. Save the JApplet as 
JSammys.java, and save the HTML host file as Test)Sammys.html. 
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Working with the Java 
Platform 


In this appendix, you will: 


Configure Windows to work with the Java SE Development Kit 


Use Notepad to save and edit source code 
Use TextPad to work with Java 





Unless noted otherwise, all images are © 2014 Cengage Learning 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


APPENDIX A Working with the Java Platform 


Configuring Windows to Work with the Java SE 
Development Kit 


Several versions of Java are available for free at the Java Web site (www.oracle.com/ 

technetwork/java/index.html). The official name of the most recent version is Java Platform, 

994 Standard Edition 7, often called Java SE 7 for short. Two version numbers (for example, 1.7.0 
and 7) are used to identify this release of the Java Platform. Version 7 is the product version, 
and 1.7.0 is the developer version. The number 7 is used to reflect Java’s evolving level of 
maturity. As updates to existing versions emerge or entirely new versions containing 
advanced features are released, you can download them. For example, a recent update as this 
book was being written is Java SE 7u7; 7u7 is short for version 7, update 7. 





http://www. oracle.com/technetwork/java/index.html. However, the shorter URL redirects you to the longer 
one, so you can use the shorter address if it is more convenient. Each new version of Java has a code name. 
The code name for version 7 is Dolphin. The name for version 5 was Tiger, and the name for version 6 
was Mustang. 


Y Java's Web site was http://java.sun.com before Java was purchased by Oracle. Now the Web site is 


editions were called JDK 1.0.3, JDK 1.1.2 through 1.1.8, J2SE 1.2.0 through 1.4.2, and J2SE 5.0. With 
versions 6 and 7, Java is attempting to simplify the name and number changes. Java sometimes adds a “half 
step” for minor revisions in a version, such as JDK 1.7.0_05. 


YD Over the years, Java has been inconsistent in numbering new versions. Before version 6, the standard 


The different names for Java versions are somewhat confusing and frequently misused. If you 
download Java to use with this book, you want to acquire the Java Standard Edition (SE) 
Development Kit, also known as the JDK. Java also supports the Java Enterprise Edition (EE), 
which includes all of the classes in the Java SE, plus a number of classes that are more useful 
to programs running on servers than on workstations. The Java EE Development Kit is known 
as SDK. The names of the development kits have changed frequently; originally, JDK meant 
“Java Development Kit,” but that interpretation was used with the earliest Java versions and is 
no longer used officially. 


The Java Micro Edition (ME) is another Java platform, which is used for small devices such as PDAs 
(personal digital assistants), cell phones, and other consumer appliances. 


To configure your Windows operating system with the JDK, you must add the Java bin 
directory to the command path of your operating system (OS). That way, your OS will know 
where to look for the Java commands that you use. 


One way to update the OS path for Windows is to edit or set the OS path in the autoexec.bat 
file. This file is automatically executed every time you start your computer. A simpler and less 
error-prone alternative is to type two commands at the OS prompt when you want to begin a 
session of working on Java programs. (These two commands are described later in this 
appendix.) 


You do not need to be an operating system expert to issue operating system commands. 
Learning just a few commands allows you to create and run all the examples in this book. 
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Finding the Command Prompt 


To locate the command prompt on your Windows computer, click Start, point to Programs, 
point to Accessories, and then click Command Prompt. 








In earlier versions of Windows, the console window was called the MS-DOS (Microsoft Disk Operating 995 
System) prompt, or more simply, the DOS prompt. Many people still use this term instead of command 
prompt. 


Command Prompt Anatomy 


The Windows command prompt contains at least a disk drive name followed by a colon, a 
backslash, and a greater-than sign (for example, C:\>). You might also see folder or directory 
names within the command prompt just before the greater-than sign, as shown in the 
following examples: 


C:\Documents and Settings> 
C:\Documents and Settings\Administrator> 


Each directory in the path is separated by a backslash. 


Changing Directories 


You can back up one directory level by typing cd for “change directory,” followed by two 
periods: 


cd.. 


For example, if your OS prompt contains C:\Documents and Settings\Primary> and you type 
d.., the command prompt changes to C:\Documents and Settings>. If you type cd. . again, 
the prompt changes to C:\>, indicating the root directory. Figure A-1 shows this progression. 


i 


C:\Documents and Settings\Primary>cd.. 








C:\Documents and Settings>cd.. 


Cz\> 











Figure A-1 Results following two cd. . commands 
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When you have multiple directories to back through, it is easier to use the following 
command: 


cd\ 


This takes you immediately to the root directory instead of backing up one level at a time. 
996 





At the command prompt, you can change to another disk drive by typing its name and a 
colon, then pressing Enter. For example, the following command changes the command 
prompt to refer to the A drive: 


A: 


You can change the directory by typing cd followed by the name of the directory. For 
example, if you have a folder named Java and it contains a folder named Chapter.01, you can 
change the command prompt to the Chapter.01 folder by backing up to the root directory 
and typing the following: 





fi 





cd Java fH Command Prompt “=" a 
cd Chapter.01 


oy ase C2o\>cd Jave 
As shown in Figure A-2, the command prompt Sea 


now reads C:\Java\Chapter.01>. When you C:\Java>cd Chapter .61 
compile and execute your Java programs, you (C:\Java\Chapter.@1> 
should start from the command prompt where 
the files are stored. 





When your command prompt display is filled 
with commands, it can look confusing. If you 
want, you can type cls (for Clear Screen) to 
remove old commands. 


Figure A-2 Changing to the 
Java\Chapter.01 directory from the 
root directory 


Setting the class and classpath Variables 


When you start a Java session, you might need to set the class and classpath options. These 
settings tell the operating system where to find the Java compiler and your classes. If you or 
someone else has altered your autoexec.bat file to contain these commands, you do not need 
to type them. Otherwise, every time you want to compile and execute Java programs, you 
need to type statements similar to the following: 


path = c:\program files\java\jdk1.7.0\bin 
set classpath=. 


After you have typed the class and classpath statements, you can compile and run as many 
Java programs as you want without typing these commands again. You must type them again 
if you close the Command Prompt window or restart your computer. 


The first statement sets the path and allows the OS to recognize the javac command you use 
when compiling programs. Consider the following example: 


path = c:\program files\java\jdk1.7.0\bin 
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This example assumes that you are using JDK 1.7.0 and that it is stored in the java folder in 
the program files folder. These are the defaults when you download Java from the Java Web 
site; if you installed Java in a different location, you need to alter the command accordingly. 


The command set classpath=. tells Java to find your compiled classes in the current 
directory when you execute your applications and applets. There must be no space between 997 
classpath and the equal sign, or between the equal sign and the period. 








After you set the path correctly, you should be able to use the javac command. If you attempt 
to compile a Java class and see an error message that javac is not a recognized command, 

either Java was not properly installed or the path command was incorrect. If classes compile 
successfully but do not execute, you might have entered the classpath command incorrectly. 


Changing a File’s Name 


When working through the examples in this book, you will often find it convenient to change 
the name of an existing file—for example, when you want to experiment with altering code 
without losing the original version, or if you find that when you previously saved a file, you 
mistyped a filename so that it did not match the class name within the java file you created. 
You can take at least three approaches: 


e Open the existing file using the appropriate software application (for example, Notepad), 
click File on the menu bar, and then click Save As. Select the folder you want, then type a 
new filename for the file. Now you have two versions—one with the old name and one 
with the new. 


e In Windows, open My Computer and locate the misnamed file. Select the file and then 
click the filename. (Do not double-click the filename unless you want to open the file.) 
You can then edit the filename by using a combination of the Backspace, Delete, and 
character keys. Press Enter when the filename is correct. 


e At the command prompt, use the rename command. You type rename, a space, the old 
filename, another space, and the new filename. For example, to change a file named xyz. 
java to abc.java, type the following at the command prompt for the directory containing 
the existing file: 


rename xyz.java abc.java 


Compiling and Executing a Java Program 


At the command prompt, change from the default drive prompt to the drive where your 
application is stored. Then change the directory (or folder) to the directory that holds your 
application. 


To compile an application or applet, you type the javac command to start the Java compiler, 
then type a space and the complete name of the java file—for example, First.java. If the 
application doesn’t compile successfully, the path might not be set correctly to the Java JDK 
bin directory where the javac.exe file is located. Also, you might have failed to use the same 
spelling as the Java filename. 
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When you compile a java file correctly, the Java compiler creates a .class file that has the 
same filename as the .java file. Thus, a successful compilation of the First.java file creates a file 
named First.class. To run a Java application, you use the java command and the class name 
without the .class extension. For example, after an application named First.java is compiled, 
producing First.class, you execute the program using the following command: 

998 





java First 


After the program executes, control is returned to the command prompt. If a program does 
not end on its own, or you want to end it prematurely, you can press Ctrl+C to return to the 
command prompt. 


After you compile a Java program, you can execute it as many times as you want without 
recompiling. If you change the source code, you must save and compile again before you can 
see the changed results in an executed application. 


before you are satisfied with the results. If you press the Up Arrow key at the command line, the previous 


GY When you are testing a Java program, you often issue the commands to compile and execute it many times 
commands appear in reverse succession. When you find the command you want to repeat, just press Enter. 


Using Notepad to Save and Edit Source Code 


You can use the Windows Notepad text editor to save and edit the source code for Java 
programs. To start Notepad using Windows, click the Start menu, point to All Programs, 
point to Accessories, and click Notepad. After you start Notepad, you can enter and edit the 
code just as you would with any text editor. 


Saving source code in Notepad requires that the Java source file be saved with a java 
extension. Because Java is case sensitive, you must save a file with the proper capitalization. If 
the class name of the file and the filename do not match in both spelling and case, you receive 
an error when you attempt to execute compiled source code. The default extension for 
Notepad documents is .txt. To create a file with a java extension, use Save As, locate the 
folder you want, and type the filename. In Windows 7 or Vista, you can simply type the 
filename. In older Windows operating systems, type the filename with double quotation 
marks around it, as in “First.java”. This ensures that the file is not saved as “First.java.txt”. 
Then click Save. 


Using TextPad to Work with Java 


As an alternative to Notepad, you can use TextPad—a text editor that includes many features 
helpful to Java programmers. You can download a trial version from www.textpad.com. 
Unlike Notepad, TextPad is not included with Windows; to install TextPad, run the setup file 
after downloading it from the TextPad Web site, and then respond to the dialog box options. 
Because you download a trial version, you should purchase TextPad if you decide to use it 
beyond the trial period. Note that TextPad runs only under the Windows operating system. If 
you are not using Windows, you can use the text editor that comes with your operating 
system, or you can search the Web to find a text editor that better suits your needs. 
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To enter and edit source code in TextPad, you can use the same techniques that you use with 
any other Windows text editor. In short, you can use the standard Windows shortcut 
keystrokes and menus to enter, edit, and save your code. You can use the File menu to open 
and close files. You can use the Edit menu to cut, copy, and paste text, and you can use the 
Search menu to find and replace text. In addition, TextPad color-codes the source files so it is 
easier to recognize the Java syntax. TextPad also makes it easier to save Java files with the 999 
proper capitalization and extension. To compile the current source code, you can select the 
Compile Java command from the Tools menu. If the source code does not compile cleanly, 

TextPad displays a Command Results window, including line numbers that identify the 

source of problems. With TextPad, you can choose to display line numbers in your code. 











Key Terms 


Java SE 7 is the most recent version of Java. The full, official name is Java Platform, Standard 
Edition 7. 


The JDK is the Java Standard Edition Development Kit. 


The Java Enterprise Edition (EE) includes all of the classes in the Java SE, plus a number of 
classes that are more useful to programs running on servers. 


The SDK is the Java EE Development Kit. 


The Java Micro Edition (ME) is another Java platform, which is used for small devices such as 
PDAs, cell phones, and other consumer appliances. 
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Learning About Data 
Representation 


In this appendix, you will: 


Work with numbering systems 


Represent numeric values 





Represent character values 
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Understanding Numbering Systems 


You can use devices such as computers, cell phones, microwave ovens, and automobiles 

without understanding how they work internally. Likewise, you can write many Java 

programs without understanding how the data items they use are represented internally. 
ZZ 1002 However, once you learn how data items are stored, you gain a deeper understanding of 

computer programming in general and Java in particular. You also can more easily 
troubleshoot some types of problems that arise in your programs. 





The numbering system you know best is the decimal numbering system, which is based on 
10 digits, 0 through 9. When you use the decimal system, no other symbols are available; if 
you want to express a value larger than 9, you must use multiple digits from the same pool of 
10, placing them in columns. Decimal numbers are also called base 10 numbers. 


When you use the decimal system, you analyze a multicolumn number by mentally assigning 
place values to each column. The value of the rightmost column is 1, the value of the next 
column to the left is 10, the next column’s value is 100, and so on; you multiply the column 
value by 10 as you move to the left. There is no limit to the number of columns you can use; 
you simply add them to the left as you need to express higher values. For example, Figure B-1 
shows how the value 305 is represented in the decimal system. You simply multiply the digit 
in each column by the value of the column, and then add the values together. 





Value is 
100s 10s 1s 3 x 100 
3 0 5 0 x 10 
5 x1 








Figure B-1 Representing 305 in the decimal system 


The binary numbering system works in the same way as the decimal numbering system, 
except that it uses only two digits, 0 and 1. When you use the binary system and you want to 
express a value greater than 1, you must use multiple columns because no single symbol 
represents any value other than 0 or 1. Instead of each new column to the left being 10 times 
greater than the previous column, each new binary column is only two times the value of the 
previous column. Binary numbers are called base 2 numbers. 


For example, Figure B-2 shows how the numbers 9 and 305 are represented in the binary 
system. Notice that both the binary and decimal systems allow you to create numbers with 0 
in one or more columns. As with the decimal system, the binary system has no limit to the 
number of columns—you can use as many as it takes to express a value. 
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Figure B-2 Representing decimal values 9 and 305 in the binary system 





Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


APPENDIX B Learning About Data Representation 


A computer stores every piece of data it uses as a set of Os and Js. Each 0 or J is known as a 
bit, which is short for binary digit. Every computer uses Os and Js because all its values are 
stored as electronic signals that are either on or off. This two-state system is most easily 
represented using just two digits. 
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Representing Numeric Values 


In Chapter 2, you learned that a floating-point number contains decimal positions. The term 
floating-point comes from the fact that the decimal point can be at any location in the stored 
value, allowing a much larger range of possible values to be stored in the same amount of 
memoty. For example, assume that a computer could store only four digits and that the 
decimal point had to fall after the first two. The positive values that could be stored would 
then range from 00.00 through 99.99. However, if the decimal point could fall anywhere, the 
values could range from .0000 through 9999. Computers use more storage for each value, and 
store negative values as well, but the principle is the same. 


Because of the binary nature of computers, representing floating-point numbers is imprecise. 
For example, suppose you want to represent the value 1/10 (0.10). You could try using each of 
the following techniques: 


e Ifyou use two bits to store the value, only four combinations are available (00, 01, 10, 
and 11), so they can only represent 0/4, 1/4, 2/4 (or 1/2), and 3/4. None of these is exactly 
1/10, but 0/4 is the closest. 


e Suppose you use three bits. This allows twice as many combinations, or eight, and the 
closest to 1/10 is 1/8. The approximation is closer than with two bits, but still not exact. 


e Suppose you use four bits, which allows 16 combinations. The closest value to 1/10 is 
2/16. This value is no closer to 1/10 than you could achieve with three bits. 


e Suppose you use eight bits. Now, there are 256 bit combinations from 0/256 through 
255/256. The value of 26/256, at 0.1015625, is closer than any of the other values so far, 
but it’s still not exact. 


e No matter how many bits you add to the representation, doubling the number of 
combinations each time, you can never express 0.1 exactly. 


Although you cannot store 0.1 exactly, you can still display it. For example, the following two 
lines of code display 0.1 as expected: 


double oneTenth = 0.1; 
System.out.printInConeTenth) ; 


When Java displays a floating-point number, it always displays at least one digit after the 
decimal. After that, it uses only as many digits as necessary to distinguish the number from 
the nearest floating-point value it can represent. 


However, when you use 0.1 in an arithmetic statement, the imprecision becomes evident. 
Figure B-3 shows a simple program that declares two variables named oneTenth and 
threeTenths; the variables contain the values 0.1 and 0.3, respectively. Figure B-4 shows the 
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result of summing oneTenth three times and of comparing that sum to threeTenths. Because 
of floating-point imprecision, the first value is calculated to be slightly more than 0.3, so the 
comparison of oneTenth + oneTenth + oneTenth to threeTenths is false. 


‘ . ‘ 1005 [ 
import java.util.Scanner; 


public class FloatingPointTest 
{ 


public static void main(String[] args) 


{ 








double oneTenth = 0.1; 


double threeTenths = 0.3; 

System.out.printIn(oneTenth + oneTenth + oneTenth) ; 

System.out.printInConeTenth + oneTenth + oneTenth == 
threeTenths) ; 





Figure B-3_ The FloatingPointTest class 





a 
f=" Command Prompt a C= | ol 





C:\Java>java FloatingPointTest 
6 . 366600880008000084 
false 


C:=\Java> 





Figure B-4 Output of the FloatingPointTest program 


For many purposes, you do not care about the small imprecisions generated by floating-point 
calculations, but sometimes they can make a difference. For example, several popular movies 
have used the idea that small amounts of extra money can be sliced off bank balances when 
compounding interest and then siphoned to a criminal’s account. Many programmers 
recommend that you use the Java class BigDecimal when working with monetary or scientific 
values where precision is important. Additionally, be aware that when you test two floating- 
point values for equivalency, you might not get the expected results. 


When precision is not an issue, but better-looking output is important, you can format the 
output to eliminate the small imprecisions that occur far to the right of the decimal point. 
Appendix C teaches you many techniques for formatting output to a desired number of 
decimal places. 
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Representing Character Values 


The characters used in Java are represented in Unicode, which is a 16-bit coding scheme 

for characters. For example, the letter A actually is stored in computer memory as a set of 

16 zeros and ones as 0000 0000 0100 0001 (a space is inserted after each set of four digits 
7 1006 for readability). Because 16-digit numbers are difficult to read, programmers often use a 

shorthand notation called the hexadecimal numbering system, or base 16. The hexadecimal 
system uses 16 values, 0 through 9 and A through F, to represent the decimal values 0 
through 15. In hexadecimal shorthand, 0000 becomes 0, 0100 becomes 4, and 0001 becomes 
1, so the letter A is represented in hexadecimal as 0041. You tell the compiler to treat the 
four-digit hexadecimal 0041 as a single character by preceding it with the \u escape sequence. 
Therefore, there are two ways to store the character A: 





char letter 'A'; 
char letter = '\u0041'; 


GY For more information about Unicode, go to www.unicode.org. 


The second option, using hexadecimal, is obviously more difficult and confusing than the first 
method, so it is not recommended that you store letters of the alphabet using hexadecimal 
values. However, you can produce some interesting output using the Unicode format. For 
example, the sequence ‘\u0007’ produces a bell-like noise if you send it to output. Letters from 
foreign alphabets that use characters instead of letters (Greek, Hebrew, Chinese, and so on) 
and other special symbols (foreign currency symbols, mathematical symbols, geometric 
shapes, and so on) are available using Unicode but not on a standard keyboard, so it may be 
important that you know how to use Unicode characters. 


Two-digit, base 16 numbers can be converted to base 10 numbers by multiplying the left digit by 16 and 
adding the right digit. For example, hexadecimal 41 is 4 times 16 plus 1, or 65. 


In the United States, the most widely used character set traditionally has been ASCII 
(American Standard Code for Information Interchange). The ASCII character set contains 
128 characters. You can create any Unicode character by adding eight Os to the beginning of 
its ASCII character equivalent. This means that the decimal value of any ASCII character is 
the same as that of the corresponding Unicode character. For example, B has the value 66 in 
both character sets. The decimal values are important because they allow you to show 
nonprintable characters, such as a carriage return, in decimal codes. Also, the numeric values 
of the coding schemes are used when a computer sorts numbers and strings. When you sort 
characters in ascending order, for example, numbers are sorted first (because their Unicode 
values begin with decimal code 48), followed by capital letters (starting with decimal 65), and 
then lowercase letters (starting with decimal 97). 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Key Terms 


Chapter 2 contains a list of Unicode values for some commonly used characters. For a 
complete list, see www.unicode.org/charts. There you will find Greek, Armenian, Hebrew, 
Tagalog, Cherokee, and a host of other character sets. Unicode also contains characters for 
mathematical symbols, geometric shapes, and other unusual characters. The ASCII character 
set is more limited than Unicode because it contains only letters and symbols used in the 

English language. 1007 L 








Key Terms 


The decimal numbering system is based on 10 digits, 0 through 9, in which each column 
represents a value 10 times higher than the column to its right. 


The binary numbering system is based on two digits, 0 and 1, in which each column 
represents a value two times higher than the column to its right. 


A bit is each binary digit, 0 or 1, used to represent computerized values. 
Unicode is a 16-bit coding scheme for representing characters. 


The hexadecimal numbering system is based on 16 digits, 0 through F, in which each 
column represents a value 16 times higher than the column to its right. 


ASCII (American Standard Code for Information Interchange) is a character set widely used 
to represent computer data. 
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Formatting Output 


In this appendix, you will: 


Round numbers 


Use the printf () method 
Use the DecimalFormat class 
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Rounding Numbers 


In Chapter 2 and Appendix B, you learned about the imprecision of floating-point numbers. 

For example, if you write a program that subtracts 2.00 from 2.20, the result is not 0.20—it 

is 0.20000000000000018. To eliminate odd-looking output and nonintuitive comparisons 
ZZ 1010 caused by imprecise calculations in floating-point numbers, you can take the approach shown 

in the class in Figure C-1. If you want to round a number to two decimal places, note the 
shaded steps in the figure: 


e Multiply the value by 100. So, for example, 0.20000000000000018 becomes 
20.000000000000018. 





e Add 0.5. This increases a value’s whole number part by 1 if the fractional part is 0.5 or 
greater. For example, 41.6 would become 42.1. In this case, 20.000000000000018 becomes 
20.500000000000018. 


e Cast the value to an integer. In this case, 20.500000000000018 becomes 20. 
e Divide by 100. In this case, the value becomes 0.20. 


public class RoundingDemol1 
{ 
public static void main(String[] args) 
{ 
double answer = 2.20 - 2.00; 
boolean isEqual; 
isEqual = answer == 0.20; 
System.out.printIn("Before conversion"); 
System.out.printInC"answer is " + answer); 
System.out.printInC"isEqual is " + isEqual); 
answer = answer * 100; 
answer = answer + 0.5; 
answer Cint) answer; 
answer = answer / 100; 
isEqual = answer == 0.20; 
System.out.printInC"After conversion"); 
System.out.printInC"answer is " + answer); 
System.out.printInC"isEqual is " + isEqual); 





Figure C-1 The RoundingDemol class 


Figure C-2 shows the output of the program. Without rounding, the displayed difference 
between 2.20 and 2.00 is 0.2000000000000000018. However, after applying the rounding 
technique, the result is displayed as 0.2 as expected. 
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a 





fy Command Prompt 


C:\Java>java RoundingDemol 
Before conversion 
answer is 6.26660066660600618 


isEqual is false 
After conversion 1011 
answer is 6.2 


isEqual is true 








C:\Java>_ 





Figure C-2 Output of the RoundingDemol program 


As an alternative, you can use the round() method that is supplied with Java’s Math class. The 
round() method returns the nearest long value. Figure C-3 shows a program that multiplies 
the double answer by 100, rounds it, and then divides by 100.0. The output is identical to that 
shown in Figure C-2. 





| 
public class RoundingDemo2 


{ 
public static void main(String[] args) 
{ 
double answer = 2.20 - 2.00; 
boolean isEqual; 
isEqual = answer == 0.20; 
System.out.printIn("Before conversion"); 
System.out.printInC"answer is " + answer); 
System.out.printInC"isEqual is " + isEqual); 
answer = answer * 100; 
long roundedAnswer = Math. round(answer) ; 
answer = roundedAnswer / 100.0; 
isEqual = answer == 0.20; 
System.out.printInC"After conversion"); 
System.out.printInC"answer is " + answer); 
System.out.printInC"isEqual is " + isEqual); 
} 
} 


Figure C-3 The RoundingDemo2 class 


Using the printfQ Method 


When you display numbers using the printIn() method in Java applications, it sometimes 
is difficult to make numeric values appear as you want. For example, in the output in 
Figure C-2, the difference between 2.20 and 2.00 is displayed as 0.2. By default, Java eliminates 
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trailing zeros when floating-point numbers are displayed because they do not add any 
mathematical information. You might prefer to see 0.20 because the original numbers were 
both expressed to two decimal places, or, in particular, if the values represent currency. 


Additionally, you frequently want to align columns of numeric values. For example, 
BW 102 Figure C-4 shows a NumberList application that contains an array of floating-point values. 
The application displays the values using a for loop, but as the output in Figure C-5 shows, 
the numbers are not aligned by the decimal point as you usually would want numbers to 
be aligned. Because the print1n() method displays values as Strings, the displayed 
values are left-aligned, just as series of words would be. The numeric values are accurate; 
they just are not attractively arranged. 








public class NumberList 


{ 
public static void main(String[] args) 
{ 
double[] list = {0.20, 2.00, 2.20, 22.22, 
22.20, 222.00, 222.22}; 
int x; 
for(x = 0; x < list.length; ++x) 
System.out.printIn(list[x]); 
} 
} 


Figure C-4 The NumberList application 











Figure C-5 Output of the NumberList application 


The System.out.printf() method is used to format numeric values. It is a newer Java 
feature that was first included in the Formatter class in Java 1.5.0. (This is the internal version 
number of the Java Development Kit; the external version number is 5.0.) Because this class is 
contained in the java.util package, you do not need to include any import statements to use 
it. The printf(Q) method allows you to format numeric values in two useful ways: 
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By specifying the number of decimal places to display 
By specifying the field size in which to display values 


data types such as BigDecimal and Calendar, visit the Java Web site. 


Y The Formatter class contains many formats that are not covered here. To view the details of formatting 


printfQ© method is used in these examples, in Java, you can substitute System. out. format) for 


GY C programmers use a printf function that is very similar to Java’s printf© method. Although the 


System.out.printfQ. There is no difference in the way you use these two methods. 


When creating numeric output, you can specify a number of decimal places to display by 
using the printf method with two types of arguments that represent the following: 


A format string 


A list of arguments 


A format string is a string of characters; it includes optional text (that is displayed literally) 
and one or more format specifiers. A format specifier is a placeholder for a numeric value. 
Within a call to printfQ, you include one argument (either a variable or a constant) for each 
format specifier. 


The format specifiers for general, character, and numeric types contain the following 
elements, in order: 


A percent sign ( % ), which indicates the start of every format specifier 


An optional argument index, which is an integer indicating the position of the argument 
in the argument list. The integer is followed by a dollar sign. You will learn more about 
this option later in this appendix. 


Optional flags that modify the output format. The set of valid flags depends on the data 
type you are formatting. You can find more details about this feature at the Java Web site. 


An optional field width, which is an integer indicating the minimum number of characters 
to be written to the output. You will learn more about this option later in this appendix. 


An optional precision factor, which is a decimal point followed by a number and typically 
used to control the number of decimal places displayed. You will learn more about this 
option in the next section. 


The required conversion character, which indicates how its corresponding argument 
should be formatted. Java supports a variety of conversion characters, but the three you 
want to use most frequently are d, f, and s, the characters that represent decimal (base 10 
integer), floating-point (Float and double), and string values, respectively. 


If you need these display formats, you can find more details at the Java Web site. 


GY Other conversion characters include those used to display hexadecimal numbers and scientific notation. 
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For example, you can use the ConversionCharacterExamples class in Figure C-6 to display a 
declared integer and double. The main() method of the class contains three printfQ 
statements. The three calls to printf() in this class each contain a format string; the first two 
calls contain a single additional argument, and the last printf statement contains two 
arguments after the string. None of the format specifiers in this class use any of the optional 
ZZ 1014 parameters—only the required percent sign and conversion character. The first printfO 
statement uses %d in its format string as a placeholder for the integer argument at the end. The 
second printf() statement uses %f as a placeholder for the floating-point argument at the end. 
The last printf statement uses both a %d and %f to indicate the positions of the integer and 
floating-point values at the end, respectively. If you attempt to use a conversion character that is 
invalid for the data type, the program will compile, but it will throw an exception during 
execution when it encounters the wrong conversion character for the value being displayed. 








public class ConversionCharacterExamples 
{ 
public static void main(String[] args) 
{ 
int age = 23; 
double money = 123.45; 
System.out.printfC"Age is %d\n",age) ; 
System.out.printfC("Money is $%f\n", money); 
System.out.printf 
C"Age is %d and money is $%f\n", age, money); 
} 
} 











Figure C-6 The ConversionCharacterExamp les application 


Figure C-7 shows the output of the program, in which the values are inserted in the 
appropriate places in their strings. Note that floating-point values are displayed with six 
decimal positions by default. 


C:\Java>java Convers ionCharacterExamples 
Age is 23 

Money is $123.456006 

Age is 23 and money is $123.456000 








C:\Java> 











Figure C-7 Output of the ConversionCharacterExamples application 


Notice that in the ConversionCharacterExamp1es class, the output appears on three separate 
lines only because the newline character (‘\n’) has been included at the end of each printfO 
format string. Unlike the print1nQ statement, printf does not include an automatic new line. 
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Specifying a Number of Decimal Places to Display with printfQ 


You can control the number of decimal places displayed when you use a floating-point value 
in a printf© statement by adding the optional precision factor to the format specifier. 
Between the percent sign and the conversion character, you can add a decimal point and the 
number of decimal positions to display. For example, the following statements produce the 1015 | 
output “Money is $123.45”, displaying the money value with just two decimal places instead of 

six, which would occur without the precision factor: 





double money = 123.45; 
System.out.printf("Money is $%.2f\n", money); 


Similarly, the following statements display 8.10. If you use the printIn© equivalent with 
amount, only 8.1 is displayed; if you use a printf( statement without inserting the .2 
precision factor, 8.100000 is displayed. 


double amount = 8.1; 
System.out.printf("%.2f", amount) ; 


When you use a precision factor on a value that contains more decimal positions than you 
want to display, the result is rounded. For example, the following statements produce 100.457 
(not 100.456), displaying three decimals because of the precision factor. 


double value = 100.45678; 
System.out.printf("%.3f",value); 


You cannot use the precision factor with an integer value; if you do, your program will throw 
an I1legalFormatConversionException 


Specifying a Field Size with printfO 


You can indicate a field size in which to display output by using an optional integer as the field 
width. For example, the NumberList2 class in Figure C-8 displays each array element in a field 
with a size of 6, using two decimal places. Figure C-9 shows the output of the application. Each 
value is displayed right-aligned in its field; for example, 0.20 is preceded by two blank spaces, and 
22.20 is preceded by one blank space. Ifa numeric value contains more positions than you indicate 
for its printf© field size, the field size is ignored, and the entire value is displayed. 


public class NumberList2 


{ 
public static void main(String[] args) 


{ 


double[] list = {0.20, 2.00, 2.20, 22.22, 


22.20, 222.00, 222.22}; 

int x; 

for(x = 0; x < list.length; ++x) 
System.out.printf("%6.2f\n", list[x]); 





Figure C-8 The NumberList2 class 
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7 1016 











Figure C-9 Output of the NumberList2 class 


Throughout this book, you have been encouraged to use named constants for numeric values 
instead of literal constants, so that your programs are clearer. In the program in Figure C-9, 
you could define constants such as: 


final int DISPLAY_WIDTH = 6; 
final int DISPLAY_DECIMALS = 2; 


Then the printfQ statement would be: 


System.out.printf("%" + DISPLAY_WIDTH + "." + 
DISPLAY_DECIMALS + "f\n", list[x]); 


Another, perhaps clearer alternative is to define a format string such as the following: 
final String FORMAT = "%6.2f\n"; 

Then the printf(Q statement would be: 

System.out.printfCFORMAT, list[x]); 


You can specify that a value be left-aligned in a field instead of right-aligned by inserting 
a negative sign in front of the width. Although you can do this with numbers, most often 
you choose to left-align strings. For example, the following code displays five spaces 
followed by “hello” and then five spaces followed by “there”. Each string is left-aligned in 
a field with a size of 10. 


String stringl = "hello"; 


String string2 = "there"; 
System.out.printf("%-10s%-10s", stringl, string2); 


Using the Optional Argument Index with printf QO 


The argument index is an integer that indicates the position of an argument in the argument 
list of a printf( statement. To separate it from other formatting options, the argument 
index is followed by a dollar sign ( $ ). The first argument is referenced by "1$", the second by 
"2$", and so on. 
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For example, the printf() statement in the following code contains four format specifiers 
but only two variables in the argument list: 


int x = 56; 
double y = 78.9; 
System.out.printf("%1$6d%2$6.2F%1$6d%2$6.2F", x, y); 
1017 
The printf statement displays the value of the first argument, x, in a field with a size of 6, 107 





and then it displays the second argument, y, in a field with a size of 6 with two decimal places. 
Then, the value of x is displayed again, followed by the value of y. The output appears as 
follows: 


56 78.90 56 78.90 


Using the DecimalFormat Class 


The DecimalFormat class provides ways to easily convert numbers into strings, allowing you 
to control the display of leading and trailing zeros, prefixes and suffixes, grouping (thousands) 
separators, and the decimal separator. You specify the formatting properties of 
DecimalFormat with a pattern String. The pattern String is composed of symbols that 
determine what the formatted number looks like; it is passed to the DecimalFormat class 
constructor. 


The symbols you can use in a pattern String include: 

e A pound sign ( # ), which represents a digit 

e A period (.), which represents a decimal point 

e Acomma (, ), which represents a thousands separator 


e A zero (0), which represents leading and trailing zeros when it replaces the pound sign 


The pound sign is typed using Shift+3 on standard computer keyboards. It also is called an octothorpe, a 
number sign, a hash sign, square, tic-tac-toe, gate, and crunch. 


For example, the following lines of code result in value being displayed as 12,345,678.90. 


double value = 12345678.9; 
DecimalFormat aFormat = new DecimalFormat ("#, ###, ###, ###.00"); 
System.out.printf("%s\n", aFormat.format(value)) ; 


A DecimalFormat object is created using the pattern #,###,###,###.00. When the object’s 
format() method is used in the printf( statement, the first two pound signs and the 
comma between them are not used because value is not large enough to require those 
positions. The value is displayed with commas inserted where needed, and the decimal 
portion is displayed with a trailing 0 because the Os at the end of the pattern indicate that they 
should be used to fill out the number to two places. 
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When you use the DecimalFormat class, you must use the import statement import 
java.text.*;. Figure C-10 shows a class that creates a String pattern that it passes to the 
DecimalFormat constructor to create a moneyFormat object. The class displays an array of 
values, each in a field that is 10 characters wide. Some of the values require commas, and 
some do not. Figure C-11 shows the output. 


ZZ 1018 





import java.text.*; 
public class DecimalFormatTest 


{ 
public static void main(String[] args) 
{ 
String pattern = "###,###.00"; 
DecimalFormat moneyFormat = new DecimalFormat(pattern) ; 
double[] list = {1.1, 23.23, 456.249, 7890.1, 987.5678, 65.0}; 
int x; 
for(x = 0; x < list.length; ++x) 
System. out.printf("%10s\n", moneyFormat.format(list[x])); 
} 
5 


Figure C-10 The DecimalFormatTest class 





@ 
fay Command Prompt 


C:\Java>java DecimalFormatTest 
1.18 
23.23 
456.25 
7,896.16 


987.57 
65. 


C:\Java> 








Figure C-11 Output of the DecimalFormatTest program 


Key Terms 
The System.out.printf() method is used to format numeric values. 


A format string in a printfQ statement is a string of characters; it includes optional text 
(that is displayed literally) and one or more format specifiers. 


A format specifier in a printf© statement is a placeholder for a numeric value. 
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Key Terms 


The argument index in a printf© statement is an integer that indicates the position of an 
argument in the argument list. 


The DecimalFormat class provides ways to easily convert numbers into strings, allowing you 
to control the display of leading and trailing zeros, prefixes and suffixes, grouping (thousands) 


separators, and the decimal separator. 1019 L 


A pattern String is composed of symbols that determine what a formatted number looks 
like; it is passed to the DecimalFormat class constructor. 





An octothorpe is a pound sign. 
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Generating Random 
Numbers 


In this appendix, you will: 


Understand random numbers generated by computers 


Use the Math. random() method 
UsseWauatowaeshale (eyimetcisss 
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Understanding Random Numbers Generated 
by Computers 


A random number is a number whose value cannot be predicted. Many types of programs use 

random numbers. For example, simulations that predict phenomena such as urban traffic 
| 1022 patterns, crop production, and weather systems typically use random numbers. You might 
want to use random numbers to change your screen’s appearance; for example, screen savers 
often use random numbers so that a changing pattern remains interesting. 





Random numbers are also used in many computer game applications. When you play games 
with human opponents, their choices are often unpredictable (and sometimes even 
irrational). Computers usually are predictable and rational, so when you play a game against a 
computer opponent, you frequently need to generate random numbers. For example, a 
guessing game would not be very interesting if you were asked to guess the same number 
every time you played. 


Most computer programming languages, including Java, come with built-in methods that 
generate random numbers. The random numbers are calculated based on a starting value, 
called a seed. The random numbers generated using these methods are not truly random; 
they are pseudorandom in that they produce the same set of numbers whenever the seed is 
the same. Therefore, if you seed a random-number generator with a constant, you always 
receive the same sequence of values. Many computer programs use the time of day as a 
random number-generating seed. For game applications, this method works well, as a player 
is unlikely to reset his computer’s clock and attempt to replay a game beginning at exactly the 
same moment in time. 


For applications in which randomness is more crucial than in game playing, you can use other methods (such 
as using the points in time at which a radioactive source decays) to generate truly random starting numbers. 


There are two approaches to generating random numbers in Java. Both techniques are 
explained in this appendix and summarized in Table D-1. 


Method/Class Advantages 


Math. random() method You do not need to create an object 
You do not need to understand constructors and multiple methods 





Random class and its methods You can generate numbers in the format you need without arithmetic 
manipulation 
You can create reproducible results if necessary 


We) (055) Generating random numbers in Java 
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Using the Math. random() Method 


Java’s Math class provides a random() method that returns a double value in the range of 0.0 up 
to, but not including, 1.0. For example, the application in Figure D-1 generates three random 
numbers and displays them. Figure D-2 shows three successive executions of the program. 


public class SomeRandomNumbers 
{ 
public static void main (String[] args) 
{ 
double ran; 
ran = Math.random(); 
System.out.printInCran) ; 
ran = Math.random(); 
System.out.printInCran) ; 
ran = Math.random(); 
System.out.printInCran) ; 


Figure D-1 The SomeRandomNumbers class 





ei 


fx§ Command Prompt = on 


OI EUL OA Ur Mm tlulsittireclul. Cluliles acy 
6 .4161'794825457977 

6 .38626724541867844 
6.8183457138415178 


AECL OA Ur ME tilulsitlireciui. Cull es as 
6.69266935688841438 
6.64548938612152348 
6 .662263119633679365 


C:\Java>java SomeRandomNumbers 
6 .2'756276359212439 
6.6154663628111943 
6. 966339925 7643223 


C:\Java> 








Figure D-2 Three executions of the SomeRandomNumbers program 


The values displayed in Figure D-2 appear to be random, but they are not typical of the values 
you need in a game-playing program. Usually, you need a relatively small number of whole 
values. For example, a game that involves a coin flip might need only two values to represent 
heads or tails, and a dice game might need only six values to represent rolls of a single die. 
Even in a complicated game in which 40 types of space aliens might attack the player, you 
need only 40 whole numbers generated to satisfy the program requirements. 
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APPENDIX D Generating Random Numbers 


For example, suppose you need a random number from 1 to 10. To change any value 

generated by the Math. random() method to fall between 0 and 10, you can multiply the 

generated number by 10. For example, the last three numbers in Figure D-2 would become 

approximately 2.75, 6.15, and 9.66. Then, you can eliminate the fractional part of each 

number by casting it to an int; after this step, every generated number will be a value from 0 

7 1024 to 9 inclusive. Finally, you can add 1 to a value so it falls in the range from 1 to 10 instead of 0 
to 9. In short, the following statement generates a random number from 1 through 10 
inclusive, and assigns it to ran: 





int ran = 1 + Cint)(Math.randomd) * 10); 


Suppose that, instead of 1 through 10, you need random numbers from 1 through 13. (For 
example, standard decks of playing cards have 13 values from which you might want to 
select.) When you use the modulus operator ( % ) to find a remainder, the remainder is always 
a value from 0 to one less than the number. For example, if you divide any number by 4, the 
remainder is always a value from 0 through 3. Therefore, to find a number from 1 through 13, 
you can use a statement like the following: 


int ranCardValue = (Cint)(Math.random() * 100) % 13 + 1); 


In this statement, a randomly generated value (for example, 0.447) is multiplied by 100 
(producing 44.7). The result is converted to an int (44). The remainder after dividing by 13 is 
5. Finally, 1 is added so the result is 1 through 13 instead of 0 through 12 (giving 6). In short, 
the general format for assigning a random number to a variable is: 


int result = CCint) (Math.random(d) * 100) % 
HIGHEST_VALUE_WANTED + LOWEST_VALUE_WANTED) ; 


Instead of using 100 as the multiplier, you might prefer to use a higher value such as 1,000 or 10,000. For 
most games, the randomness generated using 100 is sufficient. 


Using the Random Class 


The Random class provides a generator that creates a list of random numbers. To use this class, 
you must use one of the following import statements: 


import java.util.*; 
import java.util.Random; 


You also must instantiate a random-number generator object using one of the following 
constructors: 


e RandomQ, in which the seed comes from the operating system. This constructor sets the 
seed of the random-number generator to a value that is probably distinct from any other 
invocation of this constructor. 


e Random(long seed), in which you provide a starting seed so that your results are 
reproducible 
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Using the Random Class 


After you create a random-number generator object, you can use any of the methods in 
Table D-2 to get the next random number from the generator. 








Method Explanation 1025 
nextIntCint n) Returns a pseudorandom int value between 0 (inclusive) and the specified 1025 
value n (exclusive), drawn from the random-number generator’s sequence 
nextIntQ Returns a pseudorandom int value between 0 (inclusive) and 1.0 (exclusive), 
drawn from the random-number generator’s sequence 

nextLong() Returns the next pseudorandom long value from the generator’s sequence 
nextFloat(Q) Returns the next pseudorandom float value between 0.0 and 1.0 from the 


generator’s sequence 


nextDoubleQ Returns the next pseudorandom doub1e value between 0.0 and 1.0 from the 
generator’s sequence 


nextBoolean() Returns the next pseudorandom boolean value from the generator’s sequence 


1\)(-0h4 Selected Random class methods 


For example, Figure D-3 contains an application that declares a Random generator named ran, 
using the version of the constructor that takes no arguments. This ensures that the results are 
different each time the application runs. The program then defines LIMIT as 10 and calls ran. 
nextInt(LIMIT) three times, displaying the results (see Figure D-4). 


import java.util.*; 
public class SomeRandomNumbers2 
{ 
public static void main(String[] args) 


{ 


Random ran = new Random(); 


final int LIMIT = 10; 
System.out.printCran.nextIntCLIMIT) + " 


a 
er 


System.out.print(Cran.nextIntCLIMIT) + 
System.out.printInCran.nextintCLIMIT)) ; 





Figure D-3 The SomeRandomNumbersz2 class 
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C2\Java>java Some RandomNumbers2 
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C:\Java>java SomeRandomNumbers2 





Figure D-4 Three executions of the SomeRandomNumbers2 program 


In Figure D-4, each displayed value falls between 0 and LIMIT. (Of course, to select values 
between 1 and LIMIT inclusive, you could add 1 to each result.) 


Figure D-5 shows a class using the version of the Random constructor that takes an argument 
(shaded). In this example, a value between 0 and 6 inclusive is generated 15 times. Figure D-6 
shows the output when the program is run three times. Although the 15 numbers displayed 
for each execution constitute a random list, the list is identical in each program execution. 
You use a seed when you want random but reproducible results. For games, you usually want 
to use the no-argument version of the Random constructor. 





import java.util.*; 
public class SomeRandomNumbers3 


{ 
public static void main(String[] args) 
{ 
Random ran = new Random(129867L) ; 
final int TIMES = 15; 
final int LIMIT = 7; 
forCint x = 0; x < TIMES; ++x) 
System.out.printCran.nextIntCLIMIT) +" "); 
System.out.printInQ; 
} 
} 





Figure D-5 The SomeRandomNumbers3 class 


Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 





Key Terms 








fe 
fay Command Prompt , 2 les 





C:\Java>java SomeRandomNumbers3 
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C:\Java>java SomeRandomNumbers3 
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Bic :\Java>java Some RandomNunbers3 
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C=\Java> 











Figure D-6 Three executions of the SomeRandomNumbers3 program 





Key Terms 
A random number is a number whose value cannot be predicted. 
A seed is a starting value. 


Pseudorandom numbers appear to be random but are the same set of numbers whenever the 
seed is the same. 
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Javadoc 


In this appendix, you will: 


Learn about the Javadoc documentation generator 
Understand Javadoc comment types 


Generate Javadoc documentation 
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APPENDIX E Javadoc 


The Javadoc Documentation Generator 


Javadoc is a documentation generator created by Sun Microsystems that allows you to 

generate Application Programming Interface (API) documentation in Hypertext Markup 

Language (HTML) format from Java source code. In Chapter 1, you learned that you can 
7 1030 place both line and block comments anywhere in a program to provide documentation that 

can be useful both to yourself and others. A Javadoc comment is a special form of block 
comment that provides a standard way to document Java code. After you write Javadoc 
comments, they can be interpreted by special utility programs that generate an HTML 
document. The resulting HTML document provides an attractive format for the 
documentation when you open it in a browser. Most class libraries, both commercial and 
open source, provide Javadoc documents. If you have visited the Java Web site to research 
how to use a class, you most likely have viewed documentation created by the Javadoc 
utility. 





In Chapter 1, you learned that block comments start with /* and end with */ and can span as 
many lines as necessary, and that Javadoc comments start with /** and end with */. For 
symmetry, many developers end their Javadoc comments with **/. By convention, asterisks 
start intermediate lines in a Javadoc comment. This is not required, but it helps you more 
easily distinguish comments from code. 


Javadoc comments can contain tags. A Javadoc tag is a keyword within a comment that the 
Javadoc tool can process. Tags begin with an at-sign ( @ ) and use a limited vocabulary of 
keywords. Some commonly used Javadoc tags include: 


e @author: Describes the author of a document 

e @param: Describes a parameter of a method or constructor 
e @return: Describes the return type of a method 

e @throws: Describes an exception a method may throw 


e @exception: Describes an exception 


Javadoc Comment Types 

There are two types of Javadoc comments: 

e Class-level comments that provide a description of a class 

e Member-level comments that describe the purposes of class members 


Class-level Javadoc comments provide a description of a class; you place class-level 
comments above the code that declares a class. Class-level comments frequently contain 
author tags and a description of the class. Figure E-1 shows a shaded class-level comment in a 
class. 
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Javadoc Comment Types 


yf 

* @author Joyce Farrell. 

* The Employee class contains data about one employee. 
* Fields include an ID number and an hourly pay rate. 








iw 1031 | 
public class Employee 


{ 


private int idNum; 
private double hourlyPay; 
public EmployeeCint id, double pay) 
{ 
idNum = id; 
hourlyPay = pay; 
} 
int getIdNum() 
{ 


} 
void setIdNumCint id) 
{ 


} 


return idNum; 


idNum = id; 





Figure E-1 An Employee class with classtevel comments 


Member-level Javadoc comments describe the fields, methods, and constructors of a class. 
Method and constructor comments may contain tags that describe the parameters, and 
method comments may also contain return tags. Figure E-2 shows a class with some shaded 
member-level comments. 


[** 
* @author Joyce Farrell. 
* The Employee2 class contains data about one employee. 
* Fields include an ID number and an hourly pay rate. 
* / 
public class Employee2 


{ 


/** 
* Employee ID number 
PA 
private int idNum; 
VE 
* Employee hourly pay 
Py 





Figure E-2 An Employee? class with class-level and member-level comments (continues) 
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(continued) 


private double hourlyPay; 
R= 


* Sole constructor for Employee2 


7 P| 
1032 public Employee2(int id, double pay) 


{ 





idNum = id; 
hourlyPay = pay; 
} 
e= 
* Returns the Employee2 ID number 
* 
* @return int 


7 


int getIdNum() 
{ 


return idNum; 
} 
Ves 
* Sets the Employee2 ID number 
* 


* @param id employee ID number 
R/ 

void setIdNumCint id) 

{ 


} 


idNum = id; 





Figure E-2. An Employee? class with class-level and member-level comments 


Like all program comments, Javadoc comments can contain anything. However, you should 
follow the conventions for Javadoc comments. For example, developers expect all Javadoc 
comments to begin with an uppercase letter, and they recommend that method comments 
start with a verb such as “Returns” or “Sets.” For more information, go to the Java Web site. 


Generating Javadoc Documentation 
To generate the Javadoc documentation from your class, you should do the following: 


1. Create a folder in which to store your class. For example, you might store the 
Employee2.java file in a folder named Employee2. 


2. Within the folder, you can create a Documents subfolder to hold the documentation 
that you generate. However, if you omit this step and use the syntax described in Step 
3, the folder is created for you automatically. 
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Generating Javadoc Documentation D0 


3. Go to the command prompt, and navigate to the directory that holds the Employee2. 
java file. (See Appendix A for information on finding the command prompt and 
changing directories.) From the command prompt, run the following command: 


javadoc -d Documents *.java 


The -d is the directory option. If you omit it, all the generated files are saved in the 1033 [_ 
current directory. By including this option, you indicate that the files should be saved 
in the Documents directory. 





To see the author’s name in the resulting documentation, change the Javadoc command to the following: 
javadoc -d Documents -author *.java 


If you are using the jGRASP development environment to create your Java programs, you can execute the 
Javadoc command with a button click. You can download the jGRASP program from http://jGRASP.org. 


4, Navigate to the Documents folder. You will see a number of generated files, as shown 
in Figure E-3. The list includes HTML documents with information about all the 
constants in your class, all the deprecated methods in your class, and so on. (The 
Employee2 class has no constants or deprecated methods, but you can open the files 
and view the format that the contents would take if they existed.) 





Calis > computer > 05(C) > Java > Employee? » Documents > =v | 49 || Search Doc. | 


Organize v Include in library v Share with ¥ Burn New folder 


~ 





YY Favorites 
(B Recently Changed 
)) Public 
WE Desktop 
§B Downloads 
SB] Recent Places 


i Libraries 
cE} Documents 
@ Music 
(| Pictures 
& Videos 


2 Homegroup 


= Computer 
&, 05 (c:) 


pEeCAvepy (Mm... 


15 items 











> le 


Name 


)) resources 

@) allclasses-frame 
€@) allclasses-noframe 
@) constant-values 
@) deprecated-list 
€| Employee2 

@) help-doc 

@) index 

€) index-all 

€) overview-tree 

@) package-frame 
J package-list 

€) package-summary 
@) package-tree 

4) stylesheet 


Date modified 


9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 
9/27/2010 7:25 AM 


Item type 


File folder 

HTML Document 
HTML Document 
HTML Document 
HTML Document 
HTML Document 
HTML Document 
HTML Document 
HTML Document 
HTML Document 
HTML Document 
File 

HTML Document 
HTML Document 


Cascading Style S... 














Figure E-3 Contents of the Employee2 Documents folder in Internet Explorer 
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The index.html file provides an index of all class interface, constructor, field, and method names; 
when you double-click it, the file opens in your default browser. Figure E-4 shows how the first 
part of the index.html file for Employee2 appears in Internet Explorer. If you have searched the 
Java Web site for documentation, the format of the page in Figure E-4 is familiar to you. The 
class name and other information appear in a font and style consistent with other classes in the 
7 1034 Java API. You can see information about the class constructor and the notes that you added in 
your comments. You see inheritance information—Employee2 descends directly from Object. 
The format of this documentation is familiar to users, making it much easier for them to find 
what they need than if each developer created documentation formats independently. 





> 





Package [@EESy Tree Deprecated Index Help 

















PREV CLASS NEXT CLASS FRAMES NOFRAMES All Classes 
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 
Class Employee2 


java.lang.Object 
LEmployee2 


foublic class Employee?| 
extends java.lang.Object 
[Constructor Summary | 


Constructor and Description 


Mm. 























Sole constructor for Employee2 


[Method Summary | 


Modifier and Type | Method and Description 








Methods inherited from class java.lang.Object 





clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
wait, wait 








Figure E-4 The Employee2 class documentation in Internet Explorer 


The Javadoc tool will run on .java source files that are stub files with no method bodies. This means you can 
write documentation comments and run the Javadoc tool when you are first designing classes, before you 
have written implementations for the class’s methods. 


Writing acceptable Javadoc comments requires adherence to some style standards. For 
example, professionals recommend that multiple @author tags should be listed in 
chronological order, with the creator of the class listed at the top, and that multiple @param 
tags should be listed in argument-declaration order. Additionally, Javadoc comments can 
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provide hyperlinks that allow navigation from one document to another. For example, when a 
class contains a field that is an object of another class, you might want to link to the other 
class’s documentation. For more information, see the recommendations from Java developers 
at the Java Web site. 


Specifying Visibility of Javadoc Documentation 


By default, Javadoc documents only public and protected members of an API. In other 
words, even if you write Javadoc comments for private members, the comments do not 
appear in the generated documentation unless you take special action to make them visible. 
Although the index.html file contains details about the Employee? class’s constructor and 
methods, there is no information about the private fields idNum and hourlyPay. To generate that 
documentation, you must specify private visibility by using the following javadoc command: 


javadoc -d Documents -private *.java 


Figure E-5 shows the documentation generated by this command. You can see that the newly 
generated documentation includes a Field Summary section. It lists the fields in alphabetical 
order preceded by their access specifiers and data types. Each field identifier is followed by the 
appropriate description that was provided in the Javadoc comment in the source code. 





Package [SEER Tree Deprecated Index Help 




















PREV CLASS NEXT CLASS FRAMES NOFRAMES All Classes 
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 
Class Employee2 








java.lang.Object 
L_ Employee2 





public class Employee2 
extends java.lang.Object 


[Field Summary | 


| Modifier and Type | Field and Description 


hour-lyPay 
Employee hourly pay 








private double 








private int idNum 


| Employee ID number 


[Constructor Summary | 











Constructor and Description 





|Employee2(int id, double pay) 
Sole constructor for Employee2 





Figure E-5 The Employee2 class documentation when private members are included 





1035 L 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


APPENDIX E Javadoc 


You can specify four types of visibility: 
e public—Displays public members only 
e protected—Displays public and protected members only; this is the default option 


e package—Displays package classes and members in addition to public and protected 
7 1036 members 





e private—Displays all members 





Key Terms 


Javadoc is a documentation generator created by Sun Microsystems that allows you to 
generate Application Programming Interface (API) documentation in Hypertext Markup 
Language (HTML) format from Java source code. 


A Javadoc comment is a special form of block comment that provides a standard way to 
document Java code. 


A Javadoc tag is a keyword within a comment that the Javadoc tool can process. 


Class-level Javadoc comments provide a description of a class; you place class-level 
comments above the code that declares a class. 


Member-level Javadoc comments describe the fields, methods, and constructors of a class. 
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Glossary 


absolute path—a complete file path that 
does not require any other information to 
locate a file on a system. 


abstract class—a class from which no 
concrete objects can be instantiated, but which 
can serve as a basis for inheritance. Abstract 
classes usually have one or more empty 
abstract methods. Contrast with concrete class. 


abstract data type—a type whose 
implementation is hidden and accessed 
through its public methods. 


abstract method—a method declared with 
the keyword abstract; it is a method with 
no body that must be implemented in a 
subclass. 


abstraction—the programming feature 
that allows a method name to encapsulate 
multiple statements. 


accelerator—a key combination that 
causes a menu item to be chosen, whether 
or not the menu item is visible. 


access modifier—an access specifier. 


access specifier—defines the 
circumstances under which a class can be 
accessed and the other classes that have the 
right to use a class. 


accessor methods—methods that return 
information about an object. 


accumulating—the process of repeatedly 
increasing a value by some amount to 
produce a total. 


action key—a keyboard key that does not 
generate a character. 


actionPer formed(ActionEvent e) 
method—a method that defines the actions 
that occur in response to an event. 


actual parameters—the arguments in a 
method call. Contrast with formal parameters. 


acyclic gradient—a fill pattern in which a 
color shift occurs once between two points. 


adapter class—a class that implements all 
the methods in an interface, providing an 
empty body for each method. 


add and assign operator—an operator 
that alters the value of the operand on the 
left by adding the operand on the right to it; 
it is composed of a plus sign and an equal 
sign ( += ). 

addQ) method—a method that adds 
components to a container. 


addActionListener() method—a 
method that tells a class to expect 
ActionEvents. 


addPoint© method—a method that 
adds points to a Polygon object. 

ad-hoc polymorphism—polymorphism 
that occurs when a single method name can 
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GLOSSARY 


be used with a variety of data types because 
various implementations exist; it is another 
name for method overloading. 


aggregation—a type of composition in 
which a class contains one or more 
members of another class that would 
continue to exist without the object that 
contains them. 


ZZ 1038 





algorithm—a process or set of steps that 
solves a problem. 


Allman style—the indent style in which 
curly braces are aligned and each occupies 
its own line; it is named for Eric Allman, a 
programmer who popularized the style. 
Contrast with K & R style. 


ambiguous—describes a situation in which 
the compiler cannot determine which 
method to use. 


anonymous classes—nested, local classes 
that have no identifier. 


anonymous object—an unnamed object. 


append() method—a StringBuilder 
class method that adds characters to the 
end of a StringBuilder object. 


applet—a Java program that is called from 
within another application, frequently a 
Web page. 


Applet Viewer—a program that comes with 
the JDK and displays applets without using 
a Web browser. 


appletviewer command—a command that 
starts the Applet Viewer. 


application software—programs that 
perform tasks for users. Contrast with 
system software. 


application-triggered painting —painting 
operations that occur when the internal 
state of a component has changed. Contrast 
with system-triggered painting. 


arc—a portion of a circle. 


architecturally neutral—describes the 
feature of Java that allows a program to run 
on any platform. 


argument index—in a printfO 
statement, an integer that indicates the 
position of an argument in the argument 
list. 


arguments—data items sent to methods in 
a method call. 


arithmetic operators—operators used to 
perform calculations with values. 


array—a named list of data items that all 
have the same type. 


ArrayList class—a Java class that 
provides a dynamically resizable container 
that stores lists of objects. 


Arrays Class—a built-in Java class that 
contains many useful methods for 
manipulating arrays, such as methods to 
search, fill, compare, and sort arrays. 


ascending order—the order of objects 
arranged from lowest to highest value. See 
also descending order. 


ascent—one of three measures of a Font’s 
height; it is the height of an uppercase 
character from a baseline to the top of the 
character. See also leading and descent. 


ASCIl—an acronym for American Standard 
Code for Information Interchange, a 
character set widely used to represent 
computer data. 


assert statement—a statement that 
creates an assertion. 


assertion—a Java language feature that can 
help detect logic errors and debug a 
program. 


assignment—the act of providing a value 
for a variable. 
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assignment operator—the equal sign ( = ); 
any value to the right of the equal sign is 
assigned to the variable on the left of the 
equal sign. 


associativity—describes the order in which 
operands are used with operators. 


at run time—describes the period of time 
during which a program executes. 


attributes—the characteristics that define 
an object as part of a class. 


back buffer—the offscreen image during 
double buffering. 


base class—a class that is used as a basis 
for inheritance. 


BasicStroke—a class that defines line 
types and implements the Stroke interface. 


batch processing—processing that 
involves performing the same tasks with 
many records, one after the other. 


binary files—tfiles that contain data that 
has not been encoded as text; their contents 
are in binary format. 


binary numbering system—a numbering 
system based on two digits, 0 and 1, in 
which each column represents a value two 
times higher than the column to its right. 


binary operators—operators that require 
two operands. 


bit—a binary digit, 0 or 1, used to represent 
computerized values. 


black box—a device that can be used solely 
in terms of input and output without regard 
to how it works internally. 


blank final —a final variable that has 
not yet been assigned a value. 


block—the code between a pair of curly 
braces. 





block comments—comments that start 
with a forward slash and an asterisk ( /* ) 
and end with an asterisk and a forward slash 
( */ ). Block comments can appear on a line 
by themselves, on a line before executable 
code, or on a line after executable code. 
Block comments also can extend across as 
many lines as needed. Contrast with line 
comments. 


block line transfer or blitting—the act of 
copying contents from one surface to 
another. 


Boolean values—true or false values; every 
computer decision results in a Boolean 
value. 


boolean variable—a variable of the 
boolean data type that can hold only one of 
two values—true or false. 


BorderLayout—a layout manager that 
divides a container into five regions. 


BorderLayout manager—the default 
manager class for all content panes. 


BoxLayout manager—a layout manager 
that allows multiple components to be laid 
out either vertically or horizontally. The 
components do not wrap, so a vertical 
arrangement of components, for example, 
stays vertically arranged when the frame is 
resized. 


bubble sort—a type of sort in which pairs 
of items are compared and, if necessary, 
swapped so that the smallest items “bubble” 
to the top of the list, eventually creating a 
sorted list. 


buffer—a memory location that holds data 
temporarily—for example, during input and 
output operations. 


ButtonGroup—a UI component that 
groups several components, such as 
JCheckBoxes, so a user can select only one 
at a time. 
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byte—the data type that holds very small 
integers, from —128 to 127. 


bytecode—programming statements that 
have been compiled into binary format. 


Cc 


call a procedure—to invoke a method. 


call stack—the memory location where 
the computer stores the list of method 
locations to which the system must return. 


called method—a term used to describe 
the relationship between two methods; a 
method that is invoked by another. 


calling method—a term used to describe 
the relationship between two methods; a 
method that invokes another. 


camel casing—a naming style in which an 
identifier begins with a lowercase letter and 
subsequent words within the identifier are 
capitalized. Contrast with Pascal casing. 


capacity—an attribute of an ArrayList 
whose value is the number of items it can 
hold without having to increase its size. 
Also, with a StringBuilder object, the 
actual length of the buffer, as opposed to 
that of the string contained in the buffer. 


capacity() method—a StringBuilder 
class method that returns the actual length, 
or capacity, of the StringBuilder object. 


CardLayout manager—a layout manager 
that generates a stack of containers or 
components, one on top of another. 


cast operator—an operator that performs 
an explicit type conversion; it is created by 
placing the desired result type in 
parentheses before the expression to be 
converted. 


catch block—a segment of code that can 
handle an exception that might be thrown 
by the try block that precedes it. 


catch or specify requirement—the Java 
rule that checked exceptions require 
catching or declaration. 


char—the data type that holds any single 
character. 


character—any letter, number, or special 
symbol (such as a punctuation mark) that 
makes up data. 


Character class—a class whose 
instances can hold a single character value. 
This class also defines methods that can 
manipulate or inspect single-character data. 


charAt() method—a String and 
StringBui Ider class method that requires 
an integer argument that indicates the 
position of the character that the method 
returns. 


checked exceptions—exceptions that a 
programmer should plan for and from 
which a program should be able to recover. 
Contrast with unchecked exceptions. 


child class—a derived class. 


class—a group or collection of objects with 
common properties. 


class body—the set of data items and 
methods between the curly braces that 
follow the class header. 


class client—an application or class that 
instantiates objects of another class. See 
also class user. 


class definition—a description of attributes 
and methods of objects instantiated from a 
class. 


class diagram—a visual tool that provides 
an overview of a class. It consists of a 
rectangle divided into three sections—the 
top section contains the name of the class, 
the middle section contains the names and 
data types of the attributes, and the bottom 
section contains the methods. 
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class methods—static methods that do 
not have a this reference (because they 
have no object associated with them). 


class user—an application or class that 
instantiates objects of another prewritten 
class. See also class client. 


class variables—static variables that are 
shared by every instantiation of a class. 


class-level Javadoc comments—Javadoc 
comments that provide a description of a 

class and that should be placed above the 

code that declares a class. 


clean build—a compilation that is created 
after deleting all previously compiled 
versions of a class. 


clearRect() method—a method that 
draws a rectangle using the background 
color to create what appears to be an empty 
or “clear” rectangle. 


client method—a method that calls 
another method. 


close the file—to make a file no longer 
available to an application. 


closer in scope—a term that describes the 
status of a local variable over others that it 
shadows. 


collision—describes a class-naming 
conflict. 


Color class—a class that defines built-in 
colors. 


comes into scope—describes what 
happens to a variable when it is declared. 
Contrast with goes out of scope. 


comma-separated values (CSV)—fields 
that are separated with a comma. 


commands—program statements. 


comment out—the technique of turning a 
program statement into a comment so the 
compiler will not execute its command. 





compareTo() method—a String 

class method used to compare two 
Strings; the method returns a number that 
describes the differences between the 
Strings. 


comparison operator—a relational 
operator. 


compiler—a program that translates 
language statements into machine code. A 
compiler translates an entire program 
before executing it. Contrast with 
interpreter. 


compile-time error—an error for which 
the compiler detects a violation of language 
syntax rules and is unable to translate the 
source code to machine code. 


composition—describes the relationship 
between classes when an object of one class 
is a data field within another class. See also 
has-a relationship. 


computer file—a collection of stored 
information in a computer system. 


computer program—a set of instructions 
that tells a computer what to do; software. 


computer simulations—programs that 
attempt to mimic real-world activities so 
that their processes can be improved or so 
that users can better understand how the 
real-world processes operate. 


concatenated—describes values that are 
added onto the end of another value. 


concatenation—the process of joining a 
variable to a string to create a longer string. 


concrete class—a nonabstract class from 
which objects can be instantiated. Contrast 
with abstract class. 


conditional operator—an operator that 
requires three expressions separated with a 
question mark and a colon; the operator is 
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used as an abbreviated version of the if. . . 
else structure. 


confirm dialog box—a window that can be 
created using the showConfirmDialog() 
method in the JOptionPane class and that 
displays the options Yes, No, and Cancel. 


console applications—programs that 
support character output to a computer 
screen in a DOS window. 


constant—describes values that cannot be 
changed during the execution of an 
application. 


constructor—a method that establishes an 
object. 


consume—to retrieve and discard an entry 
without using it. 


container—a type of component that holds 
other components so they can be treated as 
a single entity. 


containment hierarchy—a tree of 
components that has a top-level container 
as its root (that is, at its uppermost level). 


content pane—a component that contains 
all the visible components in a top-level 
container’s user interface. 


copyArea() method—a method that 
copies any rectangular area to a new 
location. 


counter-controlled loop—a definite loop. 
Contrast with event-controlled loop. 


counting—the process of continually 
incrementing a variable to keep track of the 
number of occurrences of some event. 


crash—a premature, unexpected, and 
inelegant end to a program. 


cyclic gradient—a fill pattern in which a 
shift between colors occurs repeatedly 
between two points. 


D 


data fields—data variables declared in a 
class outside of any method. 


data files—tfiles that consist of related 
records that contain facts and figures, 
such as employee numbers, names, and 
salaries. 


data type—describes the type of data that 
can be stored in a variable, how much 

memory the item occupies, and what types 
of operations can be performed on the data. 


dead code—unreachable statements. 


debugging—the process of locating and 
repairing a program’s error. 


decimal numbering system—the 
numbering system based on 10 digits, 0 
through 9, in which each column value 
10 times the value of the column to its 
right. 


. 


S 


DecimalFormat class—a class that 
provides ways to easily convert numbers 
into strings, allowing leading and trailing 
zeros, prefixes and suffixes, grouping 
(thousands) separators, and the decimal 
separator to be used for formatting. 


decision structure—a logical structure 
that involves choosing between alternative 
courses of action based on some value 
within a program. 


declaration—another name for a method 
header; also, the statement that assigns a 
data type and identifier to a variable. 


decrementing—the act of subtracting 1 
from a variable. 


default constructor—a constructor that 
requires no arguments. 


default package—the unnamed package 
in which a class is placed if no package is 
specified. 
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definite loop—a loop that executes a 
specific number of times; a counted loop. 
Contrast with indefinite loop. 


derived class—a class that inherits from a 
base class. 


descending order—the order of objects 
arranged from highest to lowest value. See 
also ascending order. 


descent—one of three measures of a Font’s 
height; it measures the part of characters 
that “hang below” the baseline, such as the 
tails on the lowercase letters g and j. See 
also ascent and leading. 


destroy() method—a method invoked 
in an applet when the user closes the 
browser or Applet Viewer. 


development environment—a set of tools 
that helps programmers by providing such 
features as displaying a language’s keywords 
in color. 


dialog box—a GUI object resembling a 
window that displays messages. 


direct access files—random access files. 


directories—elements in a storage 
organization hierarchy. See also folders. 


divide and assign operator—an operator 
that alters the value of the operand on the 
left by dividing the operand on the right 
into it; it is composed of a slash and an 
equal sign ( /= ). 


documentation comments—comments 
that automatically generate well-formatted 
program documentation. 


do-nothing loop—a loop that performs no 
actions other than looping. 


doub1e—a data type that can hold a 
floating-point value of up to 14 or 15 
significant digits of accuracy. Contrast 
with float. 





double buffering—the default buffering 
strategy in which JPanels are drawn 
offscreen when they are updated and 
displayed only when complete. 


Double class—a wrapper class that 
contains a simple double and useful 
methods to manipulate it. 


double-precision floating-point number— 
a type of value that is stored in a double. 


do. . .while loop—a loop that executes a 
loop body at least one time; it checks the 
loop control variable at the bottom of the 
loop after one repetition has occurred. 


draw3DRect() method—a method that 
draws a rectangle that appears to have 
“shadowing” on two of its edges—the effect 
is that of a rectangle that is lit from the 
upper-left corner and slightly raised or 
slightly lowered. 


drawArcQ) method—a method that 
draws an arc. 


drawLine() method—a method that 
draws a straight line between two points on 
the screen. 


drawOval () method—a method that 
draws an oval. 


drawPolygon() method—a method that 
draws complex shapes. 


drawRect() method—a method that 
draws the outline of a rectangle. 


drawRoundRect() method—a method 
that draws rectangles with rounded 
corners. 


drawString() method—a method that 
draws a String in a JFrame or other 
component. 


dual-alternative if—a decision structure 
that takes one of two possible courses of 
action. Contrast with single-alternative if. 





1043 [ 





Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 


GLOSSARY 


ZZ 1044 





Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
dei eemed that any suppressed content does not materially affect the overall learning experience. Cei x 


dummy values—values the user enters that 
are not “real” data but just signals to stop 
data entry. 


dynamic method binding—the ability of 
an application to select the correct subclass 
method when the program executes. See 
also late method binding. 


dynamically resizable—describes an 
object whose size can change during 
program execution. 


E 


echoing the input—the act of repeating the 
user’s entry as output so the user can 
visually confirm the entry’s accuracy. 


editable—describes a component that can 
accept keystrokes. 


element—one variable or object in an 
array. 


else clause—the part of an if. . .else 
statement that executes when the evaluated 
Boolean expression is false. 


else. . . if clause—a format used in 
nested if statements in which each 
instance of else and its subsequent if are 
placed on the same line. 


empty body—a block with no statements 
in it. 

empty statement—a statement that 
contains only a semicolon. 


encapsulation—the act of hiding data and 
methods within an object. 


endcap styles—styles applied to the ends 
of lines that do not join with other lines; 
they include CAP_BUTT, CAP_ROUND, and 
CAP_SQUARE. 


endsWithQ) method—a String class 
method that takes a String argument and 
returns true or false if a String object 





does or does not end with the specified 
argument. 


enhanced for loop—a language construct 
that cycles through an array without 
specifying the starting and ending points for 
the loop control variable. 


enum constants—the allowed values for an 
enumerated data type. 


enumerated data type—a programmer- 
created data type with a fixed set of values. 


equals() method—an Object class 
method that takes a single argument, which 
must be the same type as the type of the 
invoking object, and returns a Boolean 
value indicating whether two object 
references are equal. The method is 
overridden in the String class to evaluate 
the contents of two String objects to 
determine if they are equivalent. 


equal sIgnoreCase() method—a 
String class method that ignores case when 
determining if two Strings are equivalent. 


equivalency operator—the operator 
composed of two equal signs that compares 
values and returns true if they are equal. 


Error class—a class that represents more 
serious errors than the Exception class— 
those from which a program usually cannot 
recover. 


escape sequence—a sequence that begins 
with a backslash followed by a character; 
the pair frequently represents a nonprinting 
character. 


event—a result when a user takes action on 
a component. 


event-controlled loop—an indefinite loop. 
Contrast with counter-controlled loop. 


event-driven program—a program in 
which the user might initiate any number of 
events in any order. 
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event handler—a method that executes 
because it is called automatically when an 
appropriate event occurs. 


exception—in object-oriented 
terminology, an unexpected or error 
condition. 


Exception class—a class comprising less 
serious errors than those from the Error 
class; the Exception class represents 
unusual conditions that arise while a 
program is running, and from which the 
program can recover. 


exception handling—an object-oriented 
technique for managing errors. 


exception specification—the practice of 
using the keyword throws followed by an 
Exception type in the method header. An 
exception specification is required when a 
method throws a checked Exception that it 
will not catch but will be caught by a 
different method. 


executing—the act of carrying out a 
program statement or program. 


explicit conversion—the data type 
transformation caused by using a cast 
operator. 


extended—describes classes that have 
descended from another class. 


extends—a keyword used to achieve 
inheritance in Java. 


Extensible Hypertext Markup Language 
(XHTML)—an extension of HTML. 


F 


factory methods—methods that assist in 
object creation. 


FAQs—frequently asked questions. 


fault-tolerant—describes applications that 
are designed so that they continue to 





operate, possibly at a reduced level, when 
some part of the system fails. 


field—a data variable declared in a class 
outside of any method. In reference to storage, 
a group of characters that has some meaning. 


file channel—an object that is an avenue 
for reading and writing a file. 


Files class—a class used to perform 
operations on files and directories, such as 
deleting them, determining their attributes, 
and creating input and output streams. 


fill patterns—patterns that describe how 
drawing objects are filled in. 


f1113DRect() method—a method that 
creates filled, three-dimensional rectangles. 


fil1TArcQ method—a method that 
creates a solid arc. 


fi1110val © method—a method that 
draws a solid, filled oval. 


fi11PolygonQ method—a method that 
draws a solid shape. 


fi11Rect() method—a method that 
draws a solid, or filled, rectangle. 


final—the keyword that precedes named 
constants, that describes superclass 
methods that cannot be overridden in a 
subclass, and that describes classes in which 
all methods are final. 


finally block—a block of code that 
executes at the end of a try. . .catch 
sequence. 


fixed method binding—the opposite of 
dynamic method binding; it occurs when a 
subclass method is selected while the 
program compiles rather than while it is 
running. See also static method binding. 


float—a data type that can hold a floating- 
point value of up to six or seven significant 
digits of accuracy. Contrast with double. 
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floating-point—describes a number that 
contains decimal positions. 


floating-point division—the operation in 
which two values are divided and either or 
both are floating-point values. 


flowchart—a tool that helps programmers 
plan a program’s logic by writing the steps 
in diagram form, as a series of shapes 
connected by arrows. 


FlowLayout manager—a layout manager 
that arranges components in rows across 
the width of a Container; when the current 
row is filled, additional Components are 
placed in new rows. By default, the 
components in each row are centered. 


flushing—an operation to clear bytes that 
have been sent to a buffer for output but 
that have not yet been output to a hardware 
device. 


folders—elements in a storage organization 
hierarchy. See also directories. 


Font class—a Java class that holds 
typeface and size information. 


for loop—a loop that can be used when a 
definite number of loop iterations is 
required. 


foreach loop—the enhanced for loop. 


formal parameters—the variables in a 
method declaration that accept the values 
from actual parameters. Contrast with 
actual parameters. 


format specifier—in a printfO 
statement, a placeholder for a numeric 
value. 


format string—in a printfQ© statement, a 
string of characters that includes optional 
text (that is displayed literally) and one or 
more format specifiers. 


fragile—describes classes that are prone to 
errors. 


fully qualified identifier—describes a 
filename that includes the entire hierarchy 
in which a class is stored. 


fundamental classes—basic classes 
contained in the java. lang package that 
are automatically imported into every 
program. Contrast with optional classes. 


G 


garbage value—the unknown value stored 
in an uninitialized variable. 


generic programming—a feature of 
languages that allows methods to be used 
safely with multiple data types. 


getAvailableFontFamilyNames () 
method—a method that returns the names 
of all available fonts. 


getContentPane() method—a method 
that returns a reference to a container’s 
content pane. 


getDefaul tToolkit() method—a 
method that provides information about 
the system in use. 


getFontMetrics() method—a method 
that returns a FontMetrics object that 
contains information about the leading, 
ascent, descent, and height of a font. 


getScreenResolution() method—a 
method that returns the screen resolution 
on the current system. 


getScreenSize() method—a method 
that returns the screen size as a Dimension 
object. 


getText() method—a method that 
retrieves the String of text in a Component. 


glass pane—a pane that resides above the 
content pane in a container. It can contain 
tool tips. 


goes out of scope—describes what 
happens to a variable at the end of the block 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 


deemed that any suppressed content does not materially affect the overall learning experience. Ce: 





earning reserves the right to remoye additional content at any time if subsequent rights restrictions require it. 


in which it is declared. Contrast with comes 
into scope. 


gradient fill—a gradual shift from one 
color at one coordinate point to a different 
color at a second coordinate point. 


graphical user interfaces (GUIs)— 
environments that allow users to interact 
with a program in a graphical environment. 


Graphics class—an abstract class that 
descends directly from Object and holds 
data about graphics operations and 
methods for drawing shapes, text, and 
images. 


Graphics2D class—a class that provides 
tools for two-dimensional drawing. 


GridBagLayout manager—a layout 
manager that allows the addition of 
Components to precise locations within the 
grid, as well as to indicate that specific 
Components should span multiple rows or 
columns within the grid. 


GridLayout manager—a layout manager 
that divides a container surface into a grid. 


H 


hardware—the general term for computer 
equipment. 


has-a relationship—a relationship based 
on composition. 


hash code—a calculated number used to 
identify an object. 


header—the first line of a method; its 
declaration. 


heavyweight components—components 
that require interaction with the local 
operating system. Contrast with lightweight 
components. 


height of a font—the sum of its leading, 
ascent, and descent. 





hexadecimal numbering system—a 
numbering system based on 16 digits, 0 
through F, in which each column 
represents a value 16 times higher than the 
column to its right. 


high-level programming language—a 
language that uses a vocabulary of 
reasonable terms, such as “read,” “write,” or 
“add,” instead of referencing the sequences 
of on and off switches that perform these 
tasks. Contrast with low-level programming 
language. 


</htm1>—the tag that ends every HTML 
document. 


<htm1>—the tag that begins every HTML 
document. 


HTML, or Hypertext Markup Language— 
a simple language used to create Web pages 
for the Internet. 


identifier—the name of a program 
component such as a class, object, or 
variable. 


if clause—the part of an if. . .else 
statement that executes when the evaluated 
Boolean expression is true. 


if. . .else statement—the statement 
that provides the mechanism to perform 
one action when a Boolean expression 
evaluates as true, and to perform a 
different action when a Boolean expression 
evaluates as false. 


if statement—the single-alternative 
decision statement. 


image—a likeness of a person or thing. 


immutable—describes objects that cannot 
be changed. 


implementation—the actions that execute 
within a method; the method body. 
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implementation hiding —a principle of 
object-oriented programming that 
describes the encapsulation of method 
details within a class. 


implicit conversion—the automatic 
transformation of one data type to another. 
Also called promotion. 


import statement—a Java statement that 
allows access to a built-in Java class that is 
contained in a package. 


inclusion polymorphism—the situation in 
which a single method implementation can 
be used with a variety of related objects 
because they are objects of subclasses of the 
parameter type. See also pure 
polymorphism. 


incrementing—the act of adding 1 to a 
variable. 


indefinite loop—a loop in which the final 
number of iterations is unknown. Contrast 
with definite loop. 


indexOfQ method—a String class 
method that determines whether a specific 
character occurs within a String. If it does, 
the method returns the position of the 
character; the first position of a String 
begins with zero. The return value is —1 if 
the character does not exist in the String. 


infinite loop—a loop that never ends. 


information hiding—the object-oriented 
programming principle used when creating 
private access for data fields; a class’s 
private data can be changed or manipulated 
only by a class’s own methods, and not by 
methods that belong to other classes. 


inheritance—a mechanism that enables 
one class to inherit, or assume, both the 
behavior and the attributes of another class. 


initQ method—the first method called 
in any applet. 





initialization—the act of making an 
assignment at the time of variable 
declaration. 


inlining—an automatic process that 
optimizes performance in which calls to 
final methods are replaced with the 
expanded code of their definitions at each 
method call location. 


inner block—a block contained in an outer 
block. See also inside block. 


inner classes—nested classes that require 
an instance. See also nonstatic member 
classes. 


inner loop—a loop that is contained 
entirely within another loop. 


input dialog box—a GUI object that asks a 
question and provides a text field in which 
the user can enter a response. 


insert() method—a StringBuilder 
class method that adds characters at a 
specific location within a StringBuilder 
object. 


inside block—a block contained in an 
outside block. See also inner block. 


instance—an existing object of a class. 


instance methods—methods used with 
object instantiations. See also nonstatic 
methods. 


instance variables—the data components 
of a class. 


instanceof operator—an operator that 
determines whether an object that is the 
operand on the left is a member or 
descendant of the class that is the operand 
on the right. 


instantiate—to create an instance; to create 
an object. 


instantiation—an object; one tangible 
example of a class. 
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int—the data type used to declare 
variables and constants that store integers 
in the range of —2,147,483,648 to 
+2,147,483,647. 


integer—a whole number without decimal 
places. 


Integer class—a wrapper class that 
contains a simple integer and useful 
methods to manipulate it. 


integer division—the operation in which 
one integer value is divided by another; the 
result contains no fractional part. 


interactive program—an application in 
which the user makes direct requests, as 
opposed to one in which input comes from 
a file. 


interface—a construct similar to a class, 
except that all ofits methods must be abstract 
and all of its data (if any) must be static 
final; it declares method headers but not the 
instructions within those methods. Also used 
to describe the part of a method that a client 
sees and uses—it includes the method’s 
return type, name, and arguments. 


interpreter—a program that translates 
language statements into machine code. An 
interpreter translates and executes one 
statement at a time. Contrast with compiler. 


invoke—to call or execute a method. 


is-a relationship—the relationship 
between an object and the class of which it 
is a member. 


iteration—one loop execution. 


JApp1et—a Swing class that serves as the 
basis for inheritance for applets. 


Java—a programming language developed 
by Sun Microsystems as an object-oriented 
language used both for general-purpose 
business applications and for interactive, 





World Wide Web-based Internet 
applications. 


Java API—the application programming 
interface, a collection of information about 
how to use every prewritten Java class. 


Java applications—stand-alone Java 
programs. 


Java ARchive (JAR) file—a file that 
compresses the stored data. 


Java Enterprise Edition (EE)—a Java 
edition that includes all of the classes in the 
Java SE, plus a number of classes that are 
more useful to programs running on 
servers. 


Java Foundation Classes (JFC)—selected 
classes from the java. awt package, 
including Swing component classes. 


Java interpreter—the program that 
checks bytecode and communicates with 
the operating system, executing the 
bytecode instructions line by line within the 
Java virtual machine. 


Java Micro Edition (ME)—a Java platform 
that is used for small devices such as PDAs, 
cell phones, and other consumer 
appliances. 


Java SE 7—the most recent version of Java. 
The full, official name is Java Platform, 
Standard Edition 7. 


Java Virtual Machine (JVM)—a 
hypothetical (software-based) computer on 
which Java runs. 


java. ]lang—the package that is implicitly 
imported into every Java program and that 
contains the fundamental classes. 


Javadoc—a documentation generator that 
creates Application Programming Interface 
(API) documentation in Hypertext Markup 
Language (HTML) format from Java source 
code. 
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Javadoc comment—a special form of 
block comment that provides a standard 
way to document Java code. 


Javadoc tag—a keyword within a 
comment that the Javadoc tool can process. 


JButton—a Component the user can click 
with a mouse to make a selection. 


JICheckBox—a UI component that consists 
of a label positioned beside a square; a user 
can click the square to display or remove a 
check mark. Usually, a JCheckBox is used to 
turn an option on or off. 


JComboBox—a UI component that 
combines two features: a display area 
showing an option and a list box containing 
additional options. The display area contains 
either a button that a user can click or an 
editable field into which the user can type. 


JDK—the Java Standard Edition 
Development Kit. 


JFrame—a container with a title bar and 
border. 


jGRASP—a development environment and 
source code editor. 


JLabel—a built-in Java Swing class that 
holds displayable text. 


JOpt ionPane—a Java class that produces 
dialog boxes. 


JPanel —a plain, borderless surface that 
can hold lightweight UI components. 


JScrol1Pane—a pane that provides scroll 
bars along the side or bottom, or both, so 
that the user can scroll initially invisible 
parts of the pane into view. 


JTextField—a component into which a 
user can type a single line of text data. 


juncture styles—styles applied to lines that 
join; they include JOIN_MITER, JOIN_ROUND, 
and JOIN_BEVEL. 





K 


K & R style—the indent style in which the 
opening brace follows the header line; it is 
named for Kernighan and Ritchie, who 
wrote the first book on the C programming 
language. Contrast with Allman style. 


key field—the field in a record that makes 
the record unique from all others. 


keyboard buffer—a small area of memory 
where keystrokes are stored before they are 
retrieved into a program. Also called the 
type-ahead buffer. 


KeyListener interface—an interface 
that provides methods that respond to 
actions the user initiates from the keyboard. 
The KeyListener interface contains three 
methods—keyPressed(), keyTyped(), and 
keyReleased(). 


keywords—the words that are part of a 
programming language. 


L 


late method binding—the ability of an 
application to select the correct subclass 
method when the program executes. See 
also dynamic method binding. 


layout manager—a class that controls 
component positioning in a UI 
environment. 


leading—one of three measures of a 
Font’s height; it is the amount of space 
between baselines. See also ascent and 
descent. 


leaf menu item—a menu item that does 
not bring up another menu. 


length field—a field that contains the 
number of elements in an array. 


lengthQ) method—a String class 
method that returns the length of a String. 
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lexicographical comparison—a 
comparison based on the integer Unicode 
values of characters. 


library of classes—a folder that provides a 
convenient grouping for classes. See also 
package. 


lightweight components—components 
written completely in Java that do not have 
to rely on the code written to run in the 
local operating system. Contrast with 
heavyweight components. 


line comments—comments that start with 
two forward slashes ( // ) and continue to 
the end of the current line. Line comments 
can appear on a line by themselves or at the 
end of a line following executable code. 
Contrast with block comments. 


listener—an object that is interested in and 
reacts to an event. 


literal constant—a value that is taken 
literally at each use. See also unnamed 
constant. 


literal string—a series of characters that 
appear exactly as entered. Any literal string in 
Java appears between double quotation marks. 


local classes—nested classes that are local 
to a block of code. 


local variable—a variable known only 
within the boundaries of a method. 


logic—describes the order of program 
statements that produce correct results. 


logic error—an error that occurs when a 
program compiles successfully but 
produces an error during execution. 


logical AND operator—an operator used 
between Boolean expressions to determine 
whether both are true. The AND operator 
is written as two ampersands ( && ). 


logical OR operator—an operator used 
between Boolean expressions to determine 





whether either expression is true. The OR 
operator is written as two pipes ( | | ). 


lTong—the data type that holds very large 
integers, from —9,223,372,036,854,775,808 
to 9,223,372,036,854,775,807. 


look and feel—describes the default 
appearance and behavior of any user 
interface. 


loop—a structure that allows repeated 
execution of a block of statements. 


loop body—the block of statements that 
executes when the Boolean expression that 
controls the loop is true. 


loop control variable—a variable whose 
value determines whether loop execution 
continues. 


loop fusion—the technique of combining 
two loops into one. 


lossless data compression—a set of rules 
that allows an exact replica of data to be 
reconstructed from a compressed version. 


low-level programming language—a 
language that corresponds closely to a 
computer processor’s circuitry. Contrast 
with high-level programming language. 
Compare with machine language. 


Ivalue—an expression that can appear on 
the left side of an assignment statement. 
Contrast with rvalue. 


machine code—machine language. 


machine language—circuitry-level 
language; a series of on and off switches. 
Compare with low-level programming 
language. 


magic number—a value that does not have 
immediate, intuitive meaning or a number 
that cannot be explained without additional 
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knowledge. Unnamed constants are magic 
numbers. 


matrix—a two-dimensional array. 


member-level Javadoc comments— 
Javadoc comments that describe the fields, 
methods, and constructors of a class. 


menu bar—a horizontal strip that is placed 
at the top of a container and that contains 
user options. 


menus—lists of user options. 


method—a program module that contains 
a series of statements that carry out a task. 


method body—the set of statements 
between curly braces that follow the 
method header and carry out the method’s 
actions. 


method header—the declaration or first 
line of a method that contains information 
about how other methods interact with it. 


method’s type—the method’s return type. 


mission critical—describes any process 
that is crucial to an organization. 


mnemonic—a key that causes an already 
visible menu item to be chosen. 


modulus operator—the percent sign; 
when it is used with two integers, the result 
is an integer with the value of the remainder 
after division takes place. Also called the 
remainder operator; sometimes called just 
mod. 


MouseEvent—the type of event generated 
by mouse manipulation. 


MouseInputListener interface—an 
interface that implements all the methods 
in both the MouseListener and 
MouseMotionListener interfaces. 


MouseListener interface—an interface 
that provides methods named 
mousePressed(), mouseClicked(), and 





mouseReleased() that are analogous to the 
keyboard event methods keyPressed(), 
keyTyped(), and keyReleased(). 


MouseMot ionListener interface—an 
interface that provides methods named 
mouseDragged() and mouseMoved() that 
detect the mouse being rolled or dragged 
across a component surface. 


multidimensional arrays—arrays that 
contain two or more dimensions. 


multimedia—describes the use of sound, 
images, graphics, and video in computer 
programs. 


multiple inheritance—the capability to 
inherit from more than one class; Java does 
not support multiple inheritance. 


multiply and assign operator—an 
operator that alters the value of the operand 
on the left by multiplying the operand on 
the right by it; it is composed of an asterisk 
and an equal sign. 


mutator methods— methods that set field 
values. 


N 


named constant—a named memory 
location whose value cannot change during 
program execution; in Java, its declaration 
includes the keyword final. 


NaN—a three-letter abbreviation for “Not a 
number.” 


nested—describes the relationship of 
statements, blocks, or classes when one 
contains the other. 


nested classes—classes contained in other 
classes. 


nested if statements—describes if 
statements when one is contained within 
the other. 
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new operator—an operator that allocates 
the memory needed to hold an object. 


nonstatic member classes—nested 
classes that require an instance. See also 
inner Classes. 


nonstatic methods—methods used with 
object instantiations. See also instance 
methods. 


nonvolatile storage—storage that does not 
require power to retain information. 
Contrast with volatile storage. 


NOT operator—the exclamation point ( ! ); 
it negates the result of any Boolean expression. 


null String—an empty String created by 
typing a set of quotes with nothing between 
them. 


numeric constant—a number whose value 
is taken literally at each use. 


0 


object—an instance of a class. 


Object class—a class defined in the 
java. lang package that is imported 
automati-cally into every Java program and 
that is the base class for all other Java 
classes. 


object-oriented programming—a style of 
programming that involves creating classes, 
creating objects from those classes, and 
creating applications that use those objects. 
Contrast with procedural programming. 


octothorpe—the pound sign. 


one-dimensional array—an array that 
contains one column of values and whose 
elements are accessed using a single 
subscript. See also single-dimensional array. 


open a file—the action that creates an 
object and associates a stream of bytes 
with it. 





operand—a value used in an arithmetic 
statement. 


operator precedence—the rules for the 
order in which parts of a mathematical 
expression are evaluated. 


optional classes—classes that reside in 
packages that must be explicitly imported 
into programs. Contrast with fundamental 
classes. 


out of bounds—describes a subscript that 
is not within the allowed range for an array. 


outer block—a block that contains a nested 
block. See also outside block. 


outer loop—a loop that contains another 
loop. 


outside block—a block that contains a 
nested block. See also outer block. 


overloading—describes using one term to 
indicate diverse meanings, or writing 
multiple methods with the same name but 
with different arguments. 


override a method—the action in which a 
child class method takes precedence over 
one in the parent class that has the same 
name and argument list. 


overrides—describes what a variable or 
method does to another with the same 
name when it takes precedence over the 
other variable. 


P 


package—a named collection or library of 
classes. See also library of classes. 


paintQ) method—a method that runs 
when Java displays a screen and that is 
commonly overridden in programs that use 
graphics. 


painting—the act of displaying or 
redisplaying a surface. 
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parallel array—an array with the same 
number of elements as another, and for 
which the values in corresponding elements 
are related. 


parameters—data items received by a 
method. 


parent class—a base class. 


parse—to break into component parts; the 
process the compiler uses to divide source 
code into meaningful portions for analysis. 


parseDouble() method—a Double class 
method that takes a String argument and 
returns its double value. 


parseIntQ method—an Integer class 
method that takes a String argument and 
returns its integer value. 


parsing—the process the compiler uses to 
divide source code into meaningful portions 
for analysis. 


Pascal casing—the style of using an 
uppercase letter to begin an identifier and 
to start each new word in an identifier. 
Contrast with camel casing. Compare to 
upper camel casing. 


passed by reference—describes a variable 
passed to a method when the address is 
passed to the method. Contrast with passed 
by value. 


passed by value—describes a variable 
passed to a method when a copy is made in 
the receiving method. Contrast with passed 
by reference. 


passing arguments—the act of sending 
arguments to a method. 


path—the complete list of the disk drive 
plus the hierarchy of directories in which a 
file resides. 


Path class—a Java class used to work with 
file information, such as location, size, 
creation date, and whether the file exists. 





path delimiter—the character used to 
separate path components. 


pattern String—an argument passed to 
the DecimalFormat constructor that is 
composed of symbols that determine what 
a formatted number looks like. 


permanent storage devices—hardware 
storage devices that retain data even when 
power is lost. 


pixels—the picture elements, or tiny dots 
of light, that make up the image on a video 
monitor. 


point size argument—an argument to the 
Font constructor that is an integer that 
represents about 1/72 of an inch. 


polymorphism—the feature of languages 
that allows the same word to be interpreted 
correctly in different situations based on the 
context; the act of using the same method 
name to indicate different implementations. 


populating an array—the act of providing 
values for all of the elements in an array. 


postfix ++ or the postfix increment 
operator—an operator that is composed by 
placing two plus signs to the right of a 
variable; it evaluates the variable, then adds 
1 to it. Contrast with prefix ++. 


posttest loop—a loop in which the loop 
control variable is tested after the loop body 
executes. Contrast with pretest loop. 


preferred size—a Component’s default size. 


prefix ++ or the prefix increment 
operator—an operator that is composed by 
placing two plus signs to the left of a 
variable; it adds 1 to the variable, then 
evaluates it. Contrast with postfix ++. 


prefix and postfix decrement operators— 
operators that subtract 1 from a variable 
before and after evaluating it, respectively. 
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pretest loop—a loop in which the loop 
control variable is tested before the loop 
body executes. Contrast with posttest loop. 


primary key—a unique identifier for data 
within a database. 


primary surface—the visible screen 
surface during double buffering. 


priming read or priming input—the first 
input statement prior to a loop that will 
execute subsequent input statements for 
the same variable. 


primitive type—a simple data type. Java’s 
primitive types are byte, short, int, long, 
float, double, char, and boolean. 


private access—refers to a field that no 
other classes can access. 


procedural programming—a style of 
programming in which sets of operations 
are executed one after another in sequence. 
Contrast with object-oriented programming. 


procedures—-sets of operations performed 
by a computer program. 


program—a set of written computer 
instructions. 


program comments—nonexecuting 
statements added to a Java file for the 
purpose of documentation. 


program files—files that store software 
instructions. 


program statements—similar to English 
sentences; they carry out the tasks that 
programs perform. 


programmer-defined data type—a type 
that is created by a programmer and not 
built into the language; a class. 


promotion—an implicit conversion. 


prompt—a message that requests and 
describes user input. 





property—an instance variable, field, or 
attribute of a class. 


protected—a Java keyword that provides 
an intermediate level of security between 
public and private access. Protected 
members are those that can be used by a 
class and its descendants. 


pseudocode—a tool that helps 
programmers plan a program’s logic by 
writing plain English statements. 


pseudorandom—describes numbers that 
appear to be random but are the same set of 
numbers whenever the seed is the same. 


pure polymorphism—the situation in 
which a single method implementation can 
be used with a variety of related objects 
because they are objects of subclasses of the 
parameter type. See also inclusion 
polymorphism. 


R 


ragged array—a two-dimensional array 
that has rows of different lengths. 


random access files—files in which 
records can be located in any order. 


random access memory (RAM)— 
temporary, volatile storage. 


random number—a number whose value 
cannot be predicted. 


range check—a series of statements that 
determine within which of a set of ranges a 
value falls. 


range match—the process of comparing a 
value to the endpoints of numerical ranges 
to find a category in which the value 
belongs. 


real-time—describes applications that 
require a record to be accessed immediately 
while a client is waiting. 
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record—a collection of fields that contains 
data about an entity. 


redeclare a variable—to attempt to 
declare a variable twice—an illegal action. 


reference—a variable that holds a memory 
address. 


reference to an object—the name for a 
memory address where the object is held. 


reference types—objects that hold 
memory addresses. 


regionMatches() method—a String 
class method that compares two String 
regions. 


relational operator—an operator that 
compares two items; an expression that 
contains a relational operator has a Boolean 
value. 


relative path—a path that depends on 
other path information to be complete. 


remainder and assign operator—an 
operator that alters the value of the operand 
on the left by assigning the remainder when 
the left operand is divided by the right 
operand; it is composed of a percent sign 
and an equal sign ( %= ). 


remainder operator—the percent sign; 
when it is used with two integers, the result 
is an integer with the value of the remainder 
after division takes place. Also called the 
modulus operator. 


removeQ) method—a method that 
removes components from a container. 


repaint() method—a method that 
executes when a window needs to be 
updated, such as when it contains new 
images. 


replace() method—a String class 
method that replaces all occurrences of a 
specified character within a String. 


rerender—to repaint or redisplay a 
drawing. 


return a value—to send a data value from 
a called method back to the calling 
method. 


return statement—a statement that ends 
a method and frequently sends a value 
from a called method back to the calling 
method. 


return type—the type of data that, upon 
completion of a method, is sent back to its 
calling method. 


robustness—describes the degree to which 
a system is resilient to stress, maintaining 
correct functioning. 


root directory—the main directory of a 
storage device, outside any folders. 


runtime error—an error that occurs when 
a program compiles successfully but does 
not execute. 


runtime exceptions—unplanned 
exceptions that occur during a program’s 
execution. The term is also used more 
specifically to describe members of the 
RuntimeException class. 


rvalue—an expression that can appear only 
on the right side of an assignment 
statement. Contrast with /value. 


S 


sandbox—a safe area in which a program 
can run without causing harm to other 
areas of a system. 


scalar—describes simple, primitive 
variables, such as int, double, or char. 


scientific notation—a display format that 
more conveniently expresses large or small 
numeric values; a multidigit number is 
converted to a single-digit number and 
multiplied by 10 to a power. 
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scope—in reference to a variable, the 
portion of a program within which the 
variable exists and can be referenced. 


SDK—a software development kit, or a set 
of tools useful to programmers; the Java EE 
Development Kit. 


searching an array—the process of 
comparing a value to a list of values in an 
array, looking for a match. 


seed—a starting value. 


seekable—describes a file channel in which 
operations can start at any specified position. 


semantic errors—the type of errors that 
occur when a correct word is used in the 
wrong context in program code. 


sequence structure—a logical structure in 
which one step follows another 
unconditionally. 


sequential access file—a data file in 
which each record is stored in order, based 
on the value in some field. 


setCharAt() method—a StringBuilder 
class method that changes a character at a 
specified position within a StringBuilder 

object. 


setEditableQ) method—a method that 
changes the editable status of a JTextField. 


setEnabledQ method—a method that 
makes a component available or dimmed 
and unavailable. 


setFont() method—a method that 
changes a JLabel’s font. 


setLength() method—a StringBuilder 
class method that changes the length of the 
characters in the String ina 
StringBuilder object. 


setLocation() method—a method that 
places a component at a specific location 
within a JFrame’s content pane. 





setStroke() method—a Java 2D 
method that alters a stroke’s width. 


setText() method—a method that 
changes the text in a Component that has 
already been created. 


setToolTipTextQ method—a method 
that defines the text to be displayed in a tool 
tip. 

shadowing—the action that occurs when a 
local variable hides a variable with the same 
name that is further away in scope. 


short—the data type that holds small 
integers, from —32,768 to 32,767. 


short-circuit evaluation—describes the 
feature of the AND and OR operators in 
which evaluation is performed only as far as 
necessary to make a final decision. 


showInputDialogQ method—a 
method that creates an input dialog box. 


signature—a method’s name and the 
number, types, and order of arguments. 


significant digits—refers to the 
mathematical accuracy of a value. 


single-alternative 1 f—a decision structure 
that performs an action, or not, based on 
one alternative. Contrast with dual- 
alternative if. 


single-dimensional array—an array that 
contains one column of values and whose 
elements are accessed using a single 

subscript. See also one-dimensional array. 


single-precision floating-point number— 
a type of value that is stored in a float. 


software—the general term for computer 
programs. 


sorting—the process of arranging a series 
of objects in some logical order. 


source—a component on which an event is 
generated. 
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source code—programming statements 
written in a high-level programming 
language. 


stack trace history list, or more simply 
stack trace—a list that displays all the 
methods that were called during program 
execution. 


standard arithmetic operators— 
operators that are used to perform 
common calculations. 


standard input device—normally the 
keyboard. 


standard output device—normally the 
monitor. 


startQ method—a method that executes 
after the initQ method in an applet and 
executes again every time the applet 
becomes active after it has been inactive. 


startsWith(Q method—a String class 
method that takes a String argument and 
returns true or false if a String object 
does or does not start with the specified 
argument, respectively. 


state—the values of the attributes of an 
object. 


stat ic—a keyword that means a method 
is accessible and usable even though no 
objects of the class exist. 


static member class—a type of nested 
class that has access to all static methods 
of its top-level class. 


static method binding—the opposite of 
dynamic method binding; it occurs when a 
subclass method is selected while the 
program compiles rather than while it is 
running. See also fixed method binding. 


stopQ method—a method invoked in an 
applet when a user leaves a Web page 
(perhaps by minimizing a window or 
traveling to a different Web page). 


stream—a pipeline or channel through 
which bytes flow into and out of an 
application. 


String class—a class used to work with 
fixed-string data—that is, unchanging data 
composed of multiple characters. 


String variable—a named object of the 
String class. 


StringBuilder and StringBuffer 
classes—classes used to store and 
manipulate changeable data composed of 
multiple characters that are used as 
alternatives to the String class. 


stringWidthQ) method—a 
FontMetrics class method that returns the 
integer width of a String. 


stroke—a line-drawing feature in Java 2D 
that represents a single movement using a 
drawing tool similar to a pen or pencil. 


strongly typed language—a language in 
which all variables must be declared before 
they can be used. 


stub—a method that contains no 
statements; programmers create stubs as 
temporary placeholders during the 
program development process. 


style argument—an argument to the Font 
constructor that applies an attribute to 
displayed text and is one of three values: 
Font.PLAIN, Font.BOLD, or Font. ITALIC. 


subclass—a derived class. 


subscript—an integer contained within 
square brackets that indicates one of an 
array’s variables, or elements. 


substring() method—a String class 
method that extracts part of a String. 


subtract and assign operator—an 
operator that alters the value of the operand 
on the left by subtracting the operand on 
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the right from it; it is composed of a minus 
sign and an equal sign ( —= ). 


subtype polymorphism—the ability of one 
method name to work appropriately for 
different subclasses of a parent class. 


super—a Java keyword that always refers 
to a class’s immediate superclass. 


superclass—a base class. 


Swing components—UI elements such as 
dialog boxes and buttons; their names 
usually begin with /. 


switch statement—a statement that uses 
up to four keywords to test a single variable 
against a series of exact integer or character 
values. The keywords are switch, case, 
break, and default. 


symbolic constant—a named constant. 


syntactic salt—describes a language 


feature designed to make it harder to write 
bad code. 


syntactic sugar—describes aspects of a 
computer language that make it “sweeter,” 
or easier, for programmers to use. 


syntax—the rules of a language. 


syntax error—a programming error that 
occurs when a program contains typing 
errors or incorrect language use. A program 
containing syntax errors will not compile. 


system software—the set of programs that 
manage the computer. Contrast with 
application software. 


System.out.printfQ method—a 
method used to format numeric values. 


system-triggered painting—painting 
operations that occur when the system asks 
a component to render its contents. 
Contrast with application-triggered 
painting. 





T 


table—a two-dimensional array; a matrix. 


tag attributes—arguments that promote 
activity or describe the features of an 
HTML tag. 


tags—HTML commands. 


ternary operator—an operator that needs 
three operands. 


text files—files that contain data that can 
be read in a text editor because the data has 
been encoded using a scheme such as 
ASCII or Unicode. 


this reference—a reference to an object 
that is passed to any object’s nonstatic class 
method. 


threads of execution—units of processing 
that are scheduled by an operating system 
and that can be used to create multiple 

paths of control during program execution. 


throw statement—a statement that sends 
an Exception out of a block or a method so 
it can be handled elsewhere. 


TOCTTOU bug—an error that occurs when 
changes take place from Time Of Check To 
Time Of Use. 


token—a unit of data; the Scanner class 
separates input into tokens. 


toLowerCase() method—a String class 
method that converts any String to its 
lowercase equivalent. 


tool tips—popup windows that can help a 
user understand the purpose of 
components in an application; a tool tip 
appears when a user hovers a mouse 
pointer over the component. 


top-level class—the containing class in 
nested classes. 


top-level container—a container at the 
top of a containment hierarchy. The Java 
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GLOSSARY 


top-level containers are JFrame, JDialog, 
and JApplet. 


toString() method—an Object class 
method that converts an Object into a 
String that contains information about the 
Object. Also, a String class method that 
converts any object to a String. 
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toUpperCase() method—a String class 
method that converts any String to its 
uppercase equivalent. 


try block—a block of code that a 
programmer acknowledges might generate 
an exception. 


two-dimensional array—an array that 
contains two or more columns of values 
and whose elements are accessed using 
multiple subscripts. Contrast with one- 
dimensional array. 


type-ahead buffer—the keyboard buffer. 


type casting—an action that forces a value 
of one data type to be used as a value of 
another type. 


type conversion—the process of 
converting one data type to another. 


typeface argument—an argument to the 
Font constructor that is a String 
representing a font. Common fonts have 
names such as Arial, Century, Monospaced, 
and Times New Roman. 


type-safe—describes a data type for 
which only appropriate behaviors are 
allowed. 


type-wrapper classes—a method that can 
process primitive type values. 


U 


UI components—user interface 
components, such as buttons and text 
fields, with which the user can interact. 


unary cast operator—a more complete 
name for the cast operator that performs 
explicit conversions. 


unary operator—an operator that uses 
only one operand. 


unchecked exceptions—exceptions that 
cannot reasonably be expected to be 
recovered from while a program is 
executing. Contrast with checked 
exceptions. 


Unicode—an international system of 
character representation. 


Unified Modeling Language (UML)—a 
graphical language used by programmers 
and analysts to describe classes and object- 
oriented processes. 


unifying type—a single data type to which 
all operands in an expression are converted. 


uninitialized variable—a variable that has 
been declared but that has not been 
assigned a value. 


unnamed constant—a constant value that 
has no identifier associated with it. See also 
literal constant. 


unreachable statements—statements that 
cannot be executed because the logical path 
can never encounter them; in some 
languages, including Java, an unreachable 
statement causes a compiler error. See also 


dead code. 


upcast—to change an object to an object of 
a class higher in its inheritance hierarchy. 


upper camel casing—Pascal casing. 
V 


validating data—the process of ensuring 
that a value falls within a specified range. 


variable—a named memory location 
whose contents can be altered during 
program execution. 
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variable declaration—a statement that 
reserves a named memory location. 


viewport—the viewable area in a 
JScrol1Pane. 


virtual classes—the name given to abstract 
classes in some other programming 
languages, such as C++. 


virtual key codes—codes that represent 
keyboard keys that have been pressed. 


virtual method calls—method calls in 
which the method used is determined when 
the program runs, because the type of the 
object used might not be known until the 
method executes. In Java, all instance 
method calls are virtual calls by default. 


void—a keyword that, when used in a 
method header, indicates that the method 
does not return any value when it is called. 


volatile storage—memory that requires 
power to retain information. Contrast with 
nonvolatile storage. 


W 


Web browser—a program that displays 
HTML documents on the screen. 


while loop—a construct that executes a 
body of statements continually as long as 
the Boolean expression that controls entry 
into the loop continues to be true. 


whitespace—any combination of 
nonprinting characters; for example, 
spaces, tabs, and carriage returns (blank 
lines). 


wildcard symbol—a symbol used to 
indicate that it can be replaced by any set of 
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characters. In Java, the wildcard symbol is 
an asterisk; in an import statement, the 
wildcard symbol represents all the classes in 
a package. 


window decorations—the icons and 
buttons that are part of a window or frame. 


windowed applications—programs that 
create a graphical user interface (GUI) with 
elements such as menus, toolbars, and 
dialog boxes. 


wrapped—to be encompassed in another 
type. 


wrapper—a class or object that is “wrapped 
around” a simpler element. 


“write once, run anywhere” (WORA)—a 
slogan developed by Sun Microsystems to 
describe the ability of one Java program 
version to work correctly on multiple 
platforms. 


X 


x-axis—an imaginary horizontal line that 
indicates screen position. 


x-coordinate—a position value that 
increases from left to right across a window. 


XHTML—Extensible Hypertext Markup 
Language, an extension of HTML. 


Y 


y-axis—an imaginary vertical line that 
indicates screen position. 


y-coordinate—a position value that 
increases from top to bottom across a 
window. 
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Index 


Note: Page numbers in boldface refer to definitions of key terms. 


Special Characters 
& (ampersand), 259, 259-261, 262-265, 269 
<> (angle brackets), 39, 68, 359 
* (asterisk), 32, 92, 93, 218, 312, 1030 
@ (at sign), 1030 
\ (backslash), 73, 677, 688 
: (colon), 276-277, 279 
{ (curly braces), 17, 21, 39 
$ (dollar sign), 1016 
“(double quotation mark), 73 
= (equal sign), 53, 68, 244, 245, 246, 247 
! (exclamation point), 68, 247, 277 
/ (forward slash), 32, 92, 93, 312, 677, 1030 
# (hash or pound sign, octothorpe), 1017 
- (minus sign), 92, 93, 312, 501 
() (parentheses), 39, 123-124 
% (percent sign), 92, 93, 312, 1013, 1024 
| (pipe), 261, 262, 269 
+ (plus sign), 57, 92, 93, 312, 365, 501 
? (question mark), 276-277, 279 
“(single quotation mark), 73 
[] (square brackets), 39 


A 
abs (x) method, 216 
absolute paths, 679 
converting relative paths to, 680-681 
abstract classes, 548, 548-557 
abstract data types (ADTs), 160 
abstract keyword, 549 
abstract methods, 549 
abstraction, 119 
accelerators, 858 
access modifiers, 122. See also access specifiers 


access specifiers, 16, 121-122 
accessor methods, 144 
accumulating, 312 
accurate range checks, 265—268 
acos(x) method, 216 
action keys, 841 
ActionEvents, 766, 767, 769-770, 838 
listener and handler, 840 
ActionListener class, 766, 767, 775, 776 
actionPerformedQ method, 767, 773-774, 
881, 882, 884, 956, 957, 972 
CardLayout manager, 817 
FlowLayout manager, 811-812 
actual parameters, 132 
acyclic gradients, 920, 920-921 
adapter classes, 839 
add and assign operator (+=), 312 
addQ) method, 474, 749, 749-750, 802-803, 
804, 808-809, 816, 826, 829-830 
addActionListenerQ method, 767, 775 
addItem() method, 783, 784 
addItemListenerQ method, 775 
addition operator (+), 92, 93, 279 
addPoint() method, 903 
addSeparator() method, 857 
ad-hoc polymorphism, 559 
AdjustmentEvents, listener and 
handler, 840 
AdjustmentListener, 775, 776 
ADTs (abstract data types), 160 
aggregation, 503 
algorithms, 445 
bubble sort, 444-452, 445 
insertion sort, 453-456 
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Allman, Eric, 18 
Allman style, 18 
ambiguity, 195, 195-196 
American Standard Code for Information 
Interchange (ASCII), 1006 
ampersand (&), logical AND operator, 259, 
259-261, 262-265, 269, 279-280 
AND operator, 259-261, 262—265, 269, 279-280 
angle brackets (<>), 39 
greater than operator, 359 
less than operator, 359 
anonymous classes, 227 
anonymous objects, 357 
API. See Application Programming Interface 
(API); Java API 
appendQ) method, 378 
applet(s), 11, 945-982, 946 
components, 955-961 
destroy() method, 962—963 
HTML documents to host, 948-950, 953, 
966-968 
initQ© method, 950-955, 961-962 
life cycle, 961-968 
multimedia. See multimedia 
running, 947-948, 953-955 
sound, 977—980 
start() method, 962 
stop() method, 962 
Applet Viewer, 947 
appletviewer command, 947, 947-948 
application(s) 
console. See console applications 
fault-tolerant, 608 
real-time, 704 
running, 28—29 
windowed, 11, 11-12 
application classes, 141 
application files, 676 
Application Programming Interface (API). 
See also Java API 
multimedia, 968 
Swing containers, 832 
application software, 2. See also application(s) 
application-triggered painting, 880 
arc(s), 896 
drawing, 899-901, 925 
architectural neutrality, 10 
Arc2D.Float(© class, 924 
args identifier, String objects, 19 


argument(s), 13, 127 
order, 131 
passing, 13, 19 
print and printIn statements, 60, 66 
setDefaultCloseOperation() method, 
744, 
superclass constructors requiring, 516-517 
argument index, printf() method, 1016, 
1016-1017 
arithmetic, floating-point, 98 
arithmetic operators, shortcut, 312—317 
arithmetic statements, efficient, 94 
ArithmeticException argument, 610-611, 
612 
ArithmeticException class, 606, 619, 620, 
621, 622, 627, 635, 641 
array(s), 397-433, 398, 443-488 
declaring, 398—403 
enumerations, 479-486 
initializing, 403-405 
multidimensional. See multidimensional 
arrays 
objects, 410-417 
one-dimensional (single-dimensional), 457 
parallel, 418-421, 419 
passed by reference, 427 
passing to and returning from methods, 
425-431 
populating, 404 
ragged, 462 
searching, 418, 418-425 
Strings, manipulating, 412 
subclass objects, 561-564 
subscripts (indexes), 399, 399-400 
using parts, 408—409 
variable subscripts, 406-410 
wrapped, 704 
array elements, 398 
passed by value, 426, 426-427 
sorting using bubble sort algorithm, 444—452 
sorting using insertion sort algorithm, 
453-456 
ArrayIndexOutOfBoundsException, 635, 
638 
ArrayList class, 473, 473-479 
Arrays class, 465, 465-473 
ascending order, 444: 
ascent, 912 
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ASCII (American Standard Code for Information 
Interchange), 1006 
asin(x) method, 216 
assert statements, 645, 648-649 
assertion(s), 645, 645-649 
AssertionError, 645, 648 
assignment, 53 
assignment operator (=), 53, 279 
improper use, 246 
associativity, 53 
arithmetic operators, 93 
asterisk (*) 
comments, 32 
Javadoc comments, 1030 
multiplication operator, 92, 93, 279 
multiply and assign operator, 312 
wildcard symbol, 218 
at run time, 2 
at sign (@), Javadoc tags, 1030 
atan2(x, y) method, 216 
atan(x) method, 216 
attributes, 6 
Audio file format (.au), 977 
automatic type conversion, 99—100 
automatically imported constants and methods, 
215-217 
AWTEvent class, 837, 838, 843-845 


B 
back buffer, 828 
backslash (\) 

escape characters, 688 

escape sequences, 73 

path delimiter, 677 
base classes, 503 
BasicFileAttributes object, 684 
BasicStroke class, 922 
batch processing, 703, 703-704 
BigDecimal class, 1005 
binary files, 676 
binary numbering system, 1002, 1003, 1004. 
binary operators, 91 
binarySearch() method, 466, 468, 469 
bits, 1004. 
black boxes, 127, 139 
blank finals, 54 
blitting, 828 
block(s), 180, 180-188 

inside (inner), 180, 181 


outside (outer), 180 
of code, 56 
nested, 180 
block comments, 32 
block line transfer, 828 
Boole, George, 68, 243 
boolean arrays, 404 
Boolean operators. See also AND operator; NOT 
operator; OR operator 
precedence, 278-280 
Boolean values, 243 
boolean variables, 67, 67-69 
border(s), drawing around a String, 918-919 
BorderLayout, 753, 753-754, 808-811, 809, 
818-821, 828-829 
BoxLayout manager, 808, 818 
break keyword, 271, 272 
bubble sort algorithm, 444-452, 445 
bubbleSort() method, 449 
buffer(s), 375, 690 
back, 828 
double buffering, 828 
keyboard, 80 
type-ahead, 80 
BufferedInputStream class, 691 
BufferedOutputStream class, 691, 693, 694 
BufferedReader class, 692, 696, 697, 700-702 
Bufferedwriter class, 692, 699, 708 
ButtonGroup class, 781, 781-782 
byte array, 692 
byte data type, 62, 63 
type conversion, 100, 101 
ByteBuffers, 704-705 
bytecode, 10 


Cc 


calendar(s), Gregorian and Julian, 218 
Calendar class, 548 
call stack, 636 
tracing exceptions, 636—641 
called methods, 118 
calling 
constructors during inheritance, 514-521 
methods, 118, 128-129 
procedures, 5 
camel casing, 53 
capacity, 473 
StringBuilder objects, 375 
capacity() method, 376 
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CardLayout manager, 808, 815, 815-817, 
824-826 
case keyword, 271, 272, 273 
case sensitivity, Java terms, 14 
cast operators, 100 
casting, implicit and explicit, 102-104 
catch blocks (catch clauses), 609, 609-613, 627, 
628 

multiple exceptions, 619, 620-625 
catch or specify requirement, 634. 
ceil (x) method, 216 
ChangeListener interface, 775 
changing directories, 995-996 
char arrays, 404 
char data type, 70, 70-75 

type conversion, 100 
character(s), 688 
Character class, 351 

manipulating characters, 351-356 
character values, representation, 1006-1007 
charAtQ© method, 77, 352-353, 364, 378, 468 
checkAccess() method, 681-682 
check-digits, 153 
checked exceptions, 634 
child classes, 503 
class(es), 6. See also specific classes 

abstract, 548, 548-557 

adapter, 839 

anonymous, 227 

application, 141 

base, 503 

body, 142 

child, 503 

comments, 31-34 

compiled, modifying, 29-30 

compiling, 22-28 

concept, 139-140 

concrete, 548 

confirming storage location, 29 

containing instance fields and methods, 

creating, 150 

creating, 142—143 

as data types, 160-164 

declaring, 151 

defining, 14—15 

derived, 503 

extended, 142 

extending, 504-511 

fragile, 526 


fundamental, 215 
headers, 142 
identifiers, 14, 14-16 
illegal names, 15, 16 
inner, 227 
libraries of, 215 
local, 227 
method placement within, 119 
methods. See method(s); specific methods 
nested, 227, 227-228 
nonstatic member, 227 
objects and instantiations of, 140 
optional, 215 
organizing, 147-149 
parameters accepted by methods, 128 
parent, 503 
parts, 16-17 
prewritten, importing, 217-218 
saving, 20 
static member, 227 
subclasses, 503, 508-509 
superclasses. See superclasses 
top-level, 227 
type-wrapper, 88 
unconventional names, 15, 16 
valid names, 15, 16 
virtual, 548 
class body, 17 
class clients, 141 
class definitions, 6, 7 
class diagrams, 500, 500-503 
class headers, 16 
class keyword, 16 
class methods, 208 
class users, 141 
class variable, 996 
class variables, 209 
class-level Javadoc comments, 1030, 1030-1031 
classpath settings, 218 
classpath variable, 996-997 
clean builds, 30 
clearRect() method, 894, 894-895 
clearRoundRect() method, 897 
client(s), class, 141 
client methods, 118 
cloneQ method, 565 
close() method, 692, 697, 699 
closePath() method, 925 
closer in scope, 186 


closing files, 689 
collisions, 585 
colon (:), conditional operator, 276-277, 279 
Color class, 805, 805-808 
comes into scope, 180 
command(s), 2 
command prompt, 995 
comma-separated values (CSVs), 689 
comment(s), 31-34 
block, 32 
Javadoc, 32, 1030, 1030-1032 
line, 32 
commenting out, 32 
compareTo() method, 361, 480, 482, 686 
comparison 
lexicographical, 360 
String objects, 350-351, 357-361 
comparison operators, 68 
compilers, 2 
method ambiguity, 195, 195-196 
compile-time errors, 24 
compiling, 22-28, 997-998 
component(s) 
JApplets, 955-961 
JPanels, 826-827 
Component class, 740, 750, 805 
FlowLayout manager, 811 
ComponentEvent class, 840, 844 
composition, 225, 225-227, 503 
computer files, 676, 676-677 
checking accessibility, 681-683 
closing, 689 
determining attributes, 684-687 
opening, 689 
organization, 688—689 


random access (direct access; instant access). 


See random access files 
reading from, 695-697 
sequential access, 689, 697-703 
writing to, 693-695 
computer programs, 2 
applications, 2. See also application(s) 
compiling, 997-998 
development process, 3 
event-driven. See event-driven programs 
executing, 998 
interactive, 704 
object-oriented, 5, 5-6 
types, 11-12 


computer simulations, 6 
concatenation, 56, 56—58, 364. 
concrete classes, 548 
conditional operator (?:), 276, 276-277, 279 
confirm dialog boxes, 89, 89-91 
console applications, 11, 12—22 
classes, 14-17 
indent style, 17-18 
main() method, 18-20 
saving classes, 20 
string producing output, 13-14 
const keyword, 15 
constants, 52 
automatically imported, 215-217 
BorderLayout manager, 808-809 
comparing variables, 246 
enum, 479 
final keyword, 210-211 
literal, 52 
named. See named constants 
numeric, 52 
PI, 216 
prewritten, 215 
related, interfaces to store, 578-580 
scope, 56 
StandardOpenOption argument, 694 
unnamed, 52 
constructors, 152, 156-159 
adding to instance methods, 281-284 
calling during inheritance, 514-521 
default, 156, 156-157 
Dimension class, 912 
Exception class, 641-642 
JLabel class, 749 
JPanels, 828 
JScrol] panes, 835 
JTextFields, 759 
overloading. See overloading constructors 
with parameters, creating and calling, 
196-201 
Random class, 1024 
superclass, requiring arguments, 516-517 
consumed entries, 80 
container(s), 740 
Container class, 740, 804 
ContainerEvents, listener and handlers, 840 
containment hierarchies, 802 
content pane, 802, 802—805 
controls, 740 


1067 L_ 








Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


copyArea() method, 903 

copying, areas of graphics, 903, 908-909 
correcting syntax errors, 23-24 
cos(x) method, 216 
counter-controlled loops, 305, 305-306 
counting, 312 

crashes, 606 

creationTime() method, 684 

CSVs (comma-separated values), 689 
curly braces ({}), 17, 21, 39 

cyclic gradients, 921 


D 

data compression, lossless, 969 

data fields, 142 

data files, 676 

data hiding, 153 

data representation, 1001-1007 
character values, 1006-1007 
numbering systems, 1002—1004 
numeric values, 1004—1005 

data types, 52. See also specific data types 
abstract, 160 
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automatic promotion in method calls, 180-— 


192 

classes as, 160-164 
enumerated, 479 
integer, 62, 62-67 
order of promotion, 190 
parameters accepted by methods, 128 
primitive, 52, 160 
programmer-defined, 160 
reference, 52 
type conversion, 99, 99-104. 
unifying type, 99 

dead code, 134 

debugging, 3, 31 

decimal numbering system, 1002 


decimal places, specifying number to display with 


printfQ method, 1015 
DecimalFormat class, 1017, 1017-1018 


decision(s), adding to instance methods, 281-284 


decision making, 241-287 
accurate range checks, 265-268 


adding decisions and constructors to instance 


methods, 281-284 


AND operator, 259-261, 262-265, 269, 


279-280 
conditional operator, 276, 276-277, 279 


efficient range checks, 268—269 
if and if...else structures, 244-250 
multiple statements in if and 
if...else clauses, 250-256 
nesting if and if...e1se statements, 
256-259 
NOT operator, 277-278 
operator precedence, 278-280 
OR operator, 261, 262, 269, 279-280 
planning logic, 242-244 
short-circuit evaluation, 262 
switch statement, 270-276 
decision structures, 243 
declarations, 121. See also method headers 
declaring 
arrays, 398—403 
classes, 151 
named constants, 54—56 
objects, 151-152 
String objects, 357 
variables, 53-54, 59-62 
variables in try. ..catch blocks, 616-617 
decrementing variables, 305 
default constructors, 156, 156-157 
default keyword, 271 
default packages, 584 
definite loops, 301, 301-303, 320-321 
altering loop control variables, 305-306 
deleteQ method, 683 
deleteIfExists() method, 684 
derived classes, 503 
deriveFont() method, 752 
descending order, 444 
descent, 912 
destroy() method, 962, 962-963 
development environment, 10 
dialog boxes, 34, 34—37 
confirm, 89, 89-91 
input, 85, 85-89 
Dimension class, 912 
direct access files, 704 
directories, 676, 676-677 
changing, 995-996 
display( method, 225-226, 466, 475, 
521-522 
divide and assign operator (/=), 312 
division 
floating-point, 92 
integer, 92 


Copyright 2013 Cengage Learning. All Rights Reserved. May not be copied, scanned, or duplicated, in whole or in part. Due to electronic rights, some third party content may be suppressed from the eBook and/or eChapter(s). Editorial review has 
deemed that any suppressed content does not materially affect the overall learning experience. Cengage Learning reserves the right to remove additional content at any time if subsequent rights restrictions require it. 


Division class, 605-608, 610 
division operator (/), 92, 93, 279 
documentation. See Javadoc 
documentation comments, 32 
dollar sign ($), argument index, 1016 
Dolphin, 994 
do-nothing loops, 331 
double arrays, 404 
double buffering, 828 
Double class, 372 
double data type, 69, 69-70 

type conversion, 99, 100 
double quotation mark (“), escape sequence, 73 
Double.parseDouble() method, 88 
double-precision floating-point numbers, 70 
do. . .whi le loops, 300, 321-324, 322 
draw objects, 884 
drawArc() method, 899, 899-900 
drawImage() method, 969, 970, 975 
drawing strokes, Graphics2D class, 922-923, 

926-928 

drawLine() method, 893, 893-894, 906-907 
drawOval() method, 898, 898-899 
drawPolygon() method, 901, 901-902 
drawRect() method, 894, 897 
drawRoundRect() method, 896, 896-897 
drawString() method, 885, 885-893 
draw3DRect() method, 897 
dual-alternative if, 247 
dummy values, 471 
dynamic method binding, 557-561, 559 
dynamic resizability, 473 


E 
-ea option, 648-649 
echoing the input, 78 
editing 
JTextField editability, 760 
source code, 998 
EE (Java Enterprise Edition), 994 
efficient range checks, 268-269 
elements, arrays, 398 
Ellipse2D.DoubleQ) class, 924 
Ellipse2D.Float() class, 924 
else clause, 247 
else...if clauses, 270 
Elvis operator, 276 
empty body, 304, 304—305 
empty statements, 246 


empty Strings, 361-362 
encapsulation, 8 
endcap styles, 922 
endsWith() method, 364 
enhanced for loops, 407, 412 
enum, 479, 480 
enumerated data type, 479, 479-486 
equal sign (=) 
assignment operator, 53, 246, 279 
equal to operator, 68, 247, 279 
equivalency operator, 244, 245, 246, 279, 359 
greater than or equal to operator, 68, 279 
less than or equal to operator, 68, 279 
not equal to operator, 68, 247, 279 
equal to operator (==), 68, 247, 279 
equals() method, 359, 359-361, 466, 480, 565, 
569, 569-572 
equalsIgnoreCase() method, 361 
equivalency operator (==), 244, 245, 279, 359 
error(s) 
class. See Error class; Exception class 
compile-time, 24 
logic. See logic errors 
run-time, 31 
syntax. See syntax errors 
Error class, 604, 605 
error messages, 23, 27—28 
list, 607 
escape sequences, 73 
list, 73 
event(s), 765 
hierarchy of event classes, 837-838 
listeners associated with, 838 
event handlers, 776 
creating, 839 
list, 840 
event listeners, 838 
list, 840 
Swing components, 774—777 
event-controlled loops, 306 
event-driven programs, 765, 765-774 
preparing classes to accept event messages, 766 
setEnabled() method, 770, 770-771 
telling classes how to respond to events, 
767-770 
telling classes to expect events to 
happen, 767 
EventObject class, 837, 844 
exception(s), 604 
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automatically throwing, 649-650 
catching, 609-619, 652-654. 
checked, 634 
extending classes that throw, 655-656 
multiple, throwing and catching, 619-625 
runtime, 604 
specification, 631, 631-636 
tracing through call stack, 636-641 
unchecked, 634: 
Exception catch blocks, 621 
Exception class, 604, 605, 606 
constructors, 641-642 
creating, 641-645, 656-661 
passing on, 651-652 
exception handling, 603-663, 604 
advantages, 628-631 
exception specification, 631, 631-636 
Exception types, 644 
exclamation point (!), NOT operator, 277, 279 
executing 
programs, 998 
statements, 2 
exp(x) method, 217 
explicit casting, 102-104 
explicit type conversion, 100, 100-101, 102-104 
extended classes, 142 
extending classes, 504—511 
extends clause, 576 
extends keyword, 756 
eXtensible HyperText Markup Language 
(XHTML), 947 


F 
factory methods, 678 
false value, 243, 404 
FAQs (Frequently Asked Questions), 37 
fault-tolerant applications, 608 
fields, 688 
key, 707 
MouseEvent class, 848 
specifying size with printf() method, 
1015-1016 
file(s). See computer files 
file channel objects, 704 
seekability, 704 
FileChannel class, 704 
Fi leInputStream class, 691 
filenames, changing, 997 
Fi leOutputStream class, 691 


Files class, 677, 678, 684—687, 694, 705 
FileSystem class, 578 
#1110 method, 466 
fill patterns, 920 
fi11Arc() method, 900, 900-901 
fi110val() method, 898 
f111Polygon() method, 902, 902-903 
fi11Rect( method, 894 
fi11RoundRect() method, 897 
f1113DRect() method, 897 
final constants, 54 
final keyword 
constants, 210-211 
method ambiguity, 196 
static and nonstatic fields, 211-215 
final methods, inability of subclasses to 
override in superclasses, 530-531 
final superclasses, inability of subclasses to 
override, 532 
finalize () method, 565 
finally blocks, 625, 625-628 
float arrays, 404 
Float class, 372 
float data type, 69, 69-70 
type conversion, 99, 101 
floating-point arithmetic, 98 
floating-point division, 92 
floating-point numbers, 69, 1004 
imprecision, 94—95 
floor(x) method, 217 
flow layout managers, 754 
flowcharts, 242 
FlowLayout class, 754—755, 808, 811, 811-813, 
822-823 
flush() method, 692, 699 
flushing, 690 
FocusEvents, listener and handlers, 840 
FocusListener class, 775, 776 
folders, 676, 676-677 
font(s), 909-919 
available, finding, 909-910 
comparing, 915-917 
drawing a border around a String, 918-919 
font statistics, 912-914 
FontMetrics methods, 915-919 
height of, 912 
screen statistics, 912 
Font class, 750, 750-752, 913 
FontMetrics methods, 915-919 


for loops, 300, 317, 317-321 
enhanced, 407, 412 
foreach loops, 408 
formal parameters, 132 
format specifiers, 1013 
format strings, 1013 
Formatter class, 1013 
formatting output, 1009-1019 
DecimalFormat class, 1017-1018 
printf method, 1011-1017 
rounding numbers, 1010-1011 
forward slash (/) 
comments, 32 
divide and assign operator, 312 
division operator, 92, 93, 279 
Javadoc comments, 1030 
path delimiter, 677 
fragile classes, 526 
Frequently Asked Questions (FAQs), 37 
fully quantified identifiers, 123 
functions. See method(s) 
fundamental classes, 215 


G 


garbage collector, 358 
garbage value, 54 
General Path class, 925 
generic programming, 784. 
get() method, 153, 474, 578, 972 
retrieving specific data field values, 219-220 
getArray() method, 429 
getAscent() method, 913 
getAudioClip© method, 977 
getAvai lableFontFami lyNames () 
method, 909, 909-911 
getButton() method, 847, 850 
getBytes() method, 692, 705 
getClass() method, 565 
getClickCount() method, 844, 847 
getCodeBase() method, 969, 977 
getComponent() method, 844 
getContentPane() method, 802, 802-804 
getDefaultToolkit() method, 912 
getDescent() method, 913 
getDocumentBase() method, 977 
getFileName() method, 679 
getFontMetrics() method, 913 
getGraphics() method, 885 
getHeight() method, 913 


getIconHeight() method, 972 
getIconWidth() method, 972 
getImage() method, 969 
getItemQ© method, 781, 844 
getItemAt() method, 784 
getItemCount() method, 784 
getKeyChar() method, 844 
getLeading() method, 913 
getLocalGraphics Environment(Q 
method, 910 
getMaximumRowCount() method, 784 
getMessage() method, 639, 642, 643 
getModifiers() method, 844 
getNameQ) method, 679 
getNameCount() method, 679 
getPathQ© method, 578 
getPointQ method, 844 
getScreenResolution( method, 912 
getScreenSize() method, 912 
getSelectedIndex() method, 784, 785 
getSelectedItem() method, 784 
getSelectedObjects() method, 784 
getSeparator() method, 578 
getSource() method, 844 
getStateChange() method, 780-781, 844 
getTextQ© method, 750, 780 
getTitleQ© method, 742 
getWhenQ method, 844 
getWindow() method, 844 
getX() method, 844, 847, 850 
getY() method, 844, 847, 850 
GIF (Graphics Interchange Format), 969 
glass panes, 802 
goes out of scope, 180 
goto keyword, 15 
gradient fills, 920, 920-921 
GradientPaint() method, 921 
graphical user interfaces (GUIs), 6, 801-867 
accepting input with JOptionPane class, 
85-91 
applications producing GUI output, 34—37 
color, 805-808 
content pane, 802—805 
events. See event(s); event handlers 
JPanel class, 826-834 
JScrol1Panels, 834, 834-837 
layout managers. See layout managers 
menus, 851, 851-863 
x- and y-coordinates, 845 
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graphics, 879-933 
copying areas, 903, 908-909 
creating polygons, 901-903, 925 
creating shadowed rectangles, 897-898 
drawing arcs, 899-901, 925 
drawing lines, 893-894, 906-907, 924 
drawing ovals, 898-899, 924 
drawing rectangles, 894-897, 924 
drawString() method, 885-893 
fonts. See font(s) 
Graphics2D class. See Graphics2D class 
paintQ methods, 880-882 
paintComponent() method with JPanels, 
903-905 
repaintQ method, 880, 881, 882 
Graphics class, 880, 881 
creating objects, 891-892 
parameters, 880 
screen coordinates, 892-893 
Graphics Interchange Format (GIF), 969 
GraphicsEnvironment class, 909-910 
Graphics2D class, 920, 920-930 
drawing strokes, 922-923, 926-928 
rendering attributes, 920-922 
shapes, 923-925, 928-930 
greater than operator (>), 68, 359 
greater than or equal to operator (>=), 68, 279 
Gregorian calendar, 218 
GregorianCalendar class, 218-224, 548 
Gregory XIII, Pope, 218 
GridBagLayout manager, 808, 817, 
817-818 
GridLayout manager, 808, 813, 813-815, 
823, 832 
GUIs. See graphical user interfaces (GUIs) 


H 


hardware, 2 

has-a relationships, 225 

hash codes, 567 

hash sign (#), decimal format objects, 1017 
hashCode() method, 565, 569 
heavyweight components, 740 

height of a font, 912 

help sources, 37-38 

hexadecimal numbering system, 1006 
high-level programming language, 2 
<htm1>, 949 

</htm1>, 949 


HTML (Hypertext Markup Language), 947 
hosting applets, 948-950 


I 
identifiers, 14, 14-16 
if clause, 247 
if statements, 244, 244-247 
equal sign, 246 
nested, 256, 256-259 
relational operators, 246-247 
semicolon placement, 245-246 
if...else statements, 247, 247-250 
multiple statements in, 250-256 
nested, 258-259 
image(s), 969 
adding to JApplets, 969-971, 975-976 
Image class, 969, 972 
ImageIcons, 971-975 
ImageObserver objects, 969 
immutability, 358 
implementation, methods, 121 
implementation hiding, 8, 127 
implements clause, 576 
implements keyword, 766 
implicit casting, 102-104 
implicit conversion, 99 
implicit type conversion, 99, 102-104 
import statements, 35, 218 
importing 
packages, 218 
prewritten classes, 217—218 
import. java.awt.Color statement, 805 
imprecision, floating-point numbers, 94—95 
inclusion polymorphism, 559 
incrementing variables, 305 
indefinite loops, 301, 306-308 
indent style, 17-18 
indexes, arrays, 400. See also subscripts 
indexOf() method, 363 
IndexOutOfBoundsException, 627 
infinite loops, 301, 301-302 
information hiding, 8, 143, 523-526, 525 
inheritance, 8, 8-9, 499-535, 500, 547-591 
abstract classes, 548-557 
accessing superclass methods, 521-523 
achieving good software design, 572-573 
arrays of subclass objects, 561-564. 
calling constructors, 514—521 
diagramming using UML, 500-503 








dynamic method binding, 557-561 interfaces, 127, 574, 574-583. See also graphical 
extending classes, 504—511 user interfaces (GUIs) 
information hiding, 524-526 methods, 839 
interfaces, 574—583 storing related constants, 578—580 
methods that cannot be overridden, 526-533 _ interpreters, 2 
multiple, 574 intValueQ) method, 371 1073 
Object class and its methods, 565-572 invalidate() method, 612, 750 1073 
overriding superclass methods, 511-514 invoking methods, 118 
packages, 583-588 IO classes. See input/output (IO) classes 
terminology, 503-504 IOException, 627 
jnit© method, 950-955, 951, 957, 961-962, _is-a relationships, 139, 139-140 
972 isAltDown() method, 844 
initialization, 53 isControlDown() method, 844 


arrays, 403-405 isDigitQ method, 352 
isEven() method, 646, 647 
isLetterQ method, 352 
isLetterOrDigit© method, 352 
isLowerCase() method, 352 
isResizableQ method, 742 
isSelectedQ method, 780, 855 
isShiftDownQ) method, 844 
isUpperCaseQ) method, 351, 352 
iswWhiteSpace() method, 352 
ItemEvent class, 838, 840, 844 
ItemListener class, 775, 776 
jitemStateChanged() method, 780 
iteration, loops, 300 


parallel arrays, 420 

variables in try. ..catch blocks, 616-617 
initialization lists, 404 
inlining code, 531 
inner classes, 227 
inner loops, 324, 324-329 
input dialog boxes, 85, 85-89 
InputEvent class, 844 
InputMi smatchException, 619, 620, 622 
input/output (IO) classes, 690-697 

reading from files, 695-697 

writing to files, 693-695 
InputStream class, 690, 691, 695, 700 
insertQ method, 378 J 
insertion sort(s), 453 
insertion sort algorithm, 453-456 
inside (inner) blocks, 180, 181 
instance(s), 6 
instance methods, 144 

adding decisions and constructors, 281-284 
instance variables, 142 version nanies, 994 
instanceof keyword, 506, 770 Java API, 37. See also Application Programming 
instant access files, 704 Interface (API) 
instantiation, 6 


JApplet class, 802, 946, 946-947 
JAR (Java ARchive) files, 584 
Java, 10, 10-12 
case sensitivity of terms, 14 
program types, 11-12 
reserved keywords, list, 15 


Java applications, 11, 11-22 


classes, 140 producing console output, analysis, 12-22 
objects, 218 Java ARchive (JAR) files, 584 
int data type, 62, 63 java command, 29 
returning array of, 429 Java Development Kit (JDK), 32, 37, 947, 994 
type conversion, 99, 100, 101 Java EE Development Kit (SDK), 994 
Integer class, 370, 372 Java Enterprise Edition (EE), 994 
integer data types, 62, 62-67 Java Foundation Classes (JFCs), 740 
integer division, 92 Java interpreter, 10 
Integer.parseInt( method, 88 Java Media Framework (JME), 968 
interactive programs, 704: Java Micro Edition (ME), 994 
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Java Platform Standard Edition 7 
(Java SE 7), 994, 994-998 
Java Virtual Machine (JVM), 10 
Java Web site, 37, 38 
java. awt package, 740, 920, 969 
java.awt.Applet class, 977 
java.awt.Container class, 740 
java.awt.event package, 766, 769, 837 
javac command, 22-23, 997 
Javadoc, 1029-1036, 1030 
comments, 32, 1030, 1030—1032 
generating documentation, 1032-1036 
specifying visibility of documentation, 
1035-1036 
Javadoc tags, 1030 
java. lang package, 35, 215-216, 217 
java.util package, 218 
javax. swing package, 215, 740 
javax.swing.JOptionPane package, 35 
JButton class, 760, 760-762, 772-773 
JCheckBox class, 778, 778-781, 782, 786-789 
JCheckBoxMenultem class, 855-857 
JComboBox class, 782, 782-785 
JComponents, 740 
JDialog class, 802 
JDK (Java Development Kit), 32, 37, 947, 994. 
JFCs (Java Foundation Classes), 740 
JFrame class, 740, 741-748, 802 
constructing, 742 
constructors, 741—742 
customizing JFrame appearance, 744—745 
extending, 756-758, 764—765 
layout managers, 753-755 
methods, 742 
JFrame component, 741 
JFramewithToolTip. java file, 763 
jGRASP, 10 
JLabel class, 748, 748-752 
JMenu class, 851-853 
JMenuBar objects, 851-853 
JMenulItem class, 852, 855-857 
JMF (Java Media Framework), 968 
Joint Photographic Experts Group (JPEG), 969 
JOptionPane class, 34-37, 215 
accepting GUI input, 85-91 
showConfi rmDialog() method, 89 
JOptionPane component, 740 
JPanel class, 826, 826-834, 859-863 
components, 826-827 


constructors, 828 
paintComponent() method, 903-905 
JPEG (Joint Photographic Experts Group), 969 
JRadioButton class, 782 
JRadioButtonMenultem class, 855-857 
JScrol1 panes, 834-837 
constructor, 835 
JScrol1Panels, 834 
JTextFields, 758, 758-760 
constructors, 759 
editability, 760 
Julian calendar, 218 
juncture styles, 922 
JVM (Java Virtual Machine), 10 


K 

K & R style, 17 

key codes, virtual, 841 

key fields, 707 

keyboard buffer, 80 

keyboard input, accepting using Scanner class, 

76-85 

KeyEvent class, 838, 840, 844 

KeyListener class, 775, 776, 840, 840-842 

keyPressed() method, 840-842, 846 

keyReleased() method, 840-842, 846 

keyTyped() method, 840-842, 846 

keywords, 2. See also specific keywords 
reserved, list, 15 


L 
Landin, Peter J., 634 
lastModifiedTimeQ) method, 684 
late method binding, 557-561, 559 
layout managers, 753, 753-755, 808-826 
advanced, 817-818 
with fewer than five components, 821 
list, 809 
leading, 912 
leaf menu items, 858 
length field, 407 
two-dimensional arrays, 460-461 
lengthQ) method, 363 
less than operator (<), 68, 359 
less than or equal to operator (<=), 68, 279 
lessons, downloadable, 37 
lexicographical comparison, 360 
libraries of classes, 215, 215-216 


lightweight components, 740 
line(s), drawing, 893-894, 906-907, 924 
line comments, 32 
lineToQ© method, 925 
Line2D.Doub1le() class, 924 
Line2D.Float() class, 924 
listeners, 766 
associated with events, 838 
literal constants, 52 
literal strings, 13 
local classes, 227 
local variables, 129 
log(x) method, 217 
logic, 2 
decision-making, planning, 242-244 
logic errors, 30 
correcting, 30-31 
logical AND operator (&&), 259, 259-261, 262— 
265, 269, 279-280 
logical OR operator (||), 261, 262, 269, 279-280 
Long class, 372 
long data type, 62 
type conversion, 99 
look and feel, 744 
loop(s), 299-339, 300 
for, 300, 317, 317-321 
avoiding unnecessary operations, 329-330 
combining, 332 
comparing execution times for separate and 
fused loops, 335-336 
comparing to zero, 331—332 
counter-controlled, 305, 305-306 
definite. See definite loops 
do-nothing, 331 
do. ..whi le, 300, 321-324, 322 
enhanced for, 407, 412 
event-controlled, 306 
foreach, 408 
indefinite, 301, 306-308 
infinite, 301, 301-302 
inner, 324, 324-329 
iterations, 300 
nested, 324-329 
outer, 324, 324—329 
posttest, 322 
prefix versus postfix incrementing, 
332-334 
pretest, 322 
short-circuit evaluation, 330 


shortcut arithmetic operators, 312—317 


while. See while loops 
loop body, 300 
empty, 304—305 


failing to alter loop control variables within, 


303-304. 
loop control variables, 301 
definite loops, altering, 305-306 


failing to alter within loop body, 303-304 


loop fusion, 332 

loop() method, 977-978 

lossless data compression, 969 
low-level programming language, 2 
Ivalues, 53 


machine code, 2 
machine language, 2 
magic numbers, 55 


main() method, 17, 18-20, 21—22, 118, 123, 


757, 850 
application classes, 141 
calling methods, 119, 120, 131, 144 
declaring and using variables, 59-60 
Division class, 605, 607, 610 
lacking in applets, 950 
return types, 122 
static keyword, 122 
Math class, 216-217 


Math. random() method, 1022, 1023-1024 


matrix(ces), 457 

max(x, y) method, 217 

ME (Java Micro Edition), 994 

MediaTracker objects, 972 

member-level Javadoc comments, 1031, 

1031-1032 

memory, random access, 676 

menu(s), 851, 851-863 
addSeparator() method, 857 
JCheckBoxMenultem class, 855-857 


JRadioButtonMenultem class, 855-857 


setMnemonic() method, 857-858 
menu bars, 802, 859-863 
messages, methods returning, 140-141 


method(s), 8, 118, 143-150. See also specific 


methods 
abstract, 549 
access specifiers, 121-122 
accessor, 144 
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adding parameters, 127-133 

ambiguity, 195, 195-196 

Arrays class, 465-473 

associated with objects, 140 

automatically imported, 215-217 

AWTEvent classes, 843-845 

black boxes, 127, 139 

Bufferedwriter class, 699 

called, 118 

calling, 128-129 

class, 208 

client, 118 

Color class, 806 

constructors. See constructors 

dynamic (late) method binding, 557-561, 559 

empty, 121 

ending, 133 

factory, 678 

FileChannel class, 704 

implementation, 121 

instance. See instance methods 

interfaces, 839 

invoking (calling), 118 

JCheckBox class, 780 

JComboBox class, 784—785 

JFrame class, 742 

KeyListener interface, 840-842 

Math class, 216-217 

MouseEvent class, 847 

MouseMotionListener interface, 847 

mutator, 144 

names, 123 

nonstatic, 144, 144-146 

OutputStream class, 692 

overloading. See overloading methods 

overriding, 512 

parentheses, 123-124 

passing a two-dimensional array to, 460 

passing arrays to and returning arrays from, 
425-531 

Path class, 679 

placement within a class, 119 

Random class, 1025 

receiving a single parameter, 128-130 

requiring multiple parameters, 130-132 

return types, 122 

returning messages or values, 140-141 

returning values, 133-139 

signature, 131 


static. See static method(s) 
static method binding, 559 
structure, 121 
superclasses, 521-523 
type, 133, 133-134. 
void, 128 
method body, 121 
method calls, 118 
automatic type promotion, 180-192 
chaining, 135-136 
from printlnQ method, 135 
virtual, 531 
method headers, 121, 123-124 
methodGetsArray() method, 427 
.midi or .mid (Music and Instrument Interface 
file format), 977 
min(x, y) method, 217 
minus sign (-) 
class diagrams, 501 
postfix decrement operator, 313-314, 314, 
315-317, 332-334 
prefix decrement operator, 313-314, 314, 
315-317, 332-334 
subtract and assign operator, 312 
subtraction operator, 92, 93, 279 
mission critical, 607 
mnemonics, 857, 857—858 
modules. See method(s) 
modulus operator [mod] (%), 92, 93, 279, 1024 
mouseClicked() method, 846, 850 
mouseDragged() method, 846, 847 
mouseEntered() method, 846, 850 
MouseEvent class, 838, 840, 844, 847, 848 
mouseExited() method, 846, 850 
MouseInputListener interface, 846 
MouseListener, 775, 776, 846 
MouseMotionListener interface, 775, 846, 847 
mouseMoved() method, 846, 847 
mousePressed() method, 846, 850 
mouseReleased() method, 846, 850 
MouseWheel Event class, listener and 
handlers, 840 
moveTo() method, 925 
multidimensional arrays, 457-465, 462 
two-dimensional, 457-462, 463-465 
multimedia, 968, 968—976 
adding images to JApplets, 969-971, 975-976 
adding sound to JApplets, 977-980 
ImageIcons, 971-975 








multiple inheritance, 574 notify© method, 565 
multiplication operator (*), 92, 93, 279 notifyAl1(©) method, 565 
multiply and assign operator (*=), 312 null Strings, 57, 361-362 
Music and Instrument Interface file format (.midi nul] value, 404 
or .mid), 977 Nul1PointerException, 641 
Mustang, 994. number(s) 1077 | 
mutator methods, 144 magic, 55 
pseudorandom, 1022 

N random. See random numbers 
name variable, 77 representation, 1004—1005 
nameAndAddress() method, 118-119, 122 rounding, 1010-1011 

name, 123-124 NumberFormatException, 370 


numbering systems, 1002-1004 
NumbersDialog class, 57-58 
NumbersPrint1n class, 56 


return types, 122 
named constants, 54 
adding to programs, 61-62 


declaring, 54—56 numeric constants, 52 
nested blocks, 180 numeric values, representation, 1004—1005 
nested classes, 227, 227-228 
nested if statements, 256, 256-259 O 
nested if. ..el1se statements, 258—259 object(s), 6, 6-8 
nested loops, 324—329 anonymous, 357 
new keyword, 404, 558 arrays, 410-417. See also array(s) 
new operator, 151 blocks, 180, 180-188 
newAudioClip() method, 977 concept, 139-140 
newByteChannel () method, 705 declaring and using, 151-152, 154-156 
newInputStreamQ) method, 695 instantiation, 6, 140, 218 
newline() method, 699 methods associated, 140 
newOutputStream() method, 694 properties, 407 
next() method, 77, 80 reference to, 151 
nextLine() method following, 79-81 scope, 180-188 
nextBoolean() method, 1025 state, 7 
nextByte() method, 77 Object class, 565, 565-572, 679, 690 
nextDouble() method, 77, 80, 614, 1025 object references, 563-564 
nextFloat© method, 77, 1025 object tag attributes, 949 
nextInt() method, 77, 78, 79, 80, 606, 614, object-oriented program(s), 5, 5-6 
1025 object-oriented programming (OOP), 5-9 
wrong data type entered, 81 classes, 6 
nextLine() method, 77, 615 encapsulation, 8 
following another Scanner input method, inheritance, 8, 8-9 
79-81 objects, 6, 6-8 
nextLong() method, 77, 1025 polymorphism, 9 
nextShort(Q method, 77 procedural programming compared, 9 
nonstatic fields, Final keyword, 211-215 octothorpe, 1017 
nonstatic member classes, 227 one-dimensional arrays, 457 
nonstatic methods, 144, 144-146, 202 OOP. See object-oriented programming (OOP) 
nonvolatile storage, 676 open() method, 704 
not equal to operator (!=), 68, 247, 279 opening files, 689 
NOT operator, 277, 279 operands, 91 


Notepad, 998 operator precedence, 93, 278-280 
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optional classes, 215 
OR operator, 261, 262, 269, 279-280 
ordinal (©) method, 480 
out object, 14 
out of bounds subscripts, 400 
outer loops, 324, 324—329 
OutputStream class, 690, 691, 692, 693, 694 
outside (outer) blocks, 180 
ovals, drawing, 898-899, 924 
overloading constructors, 157, 197-198, 
199-201 
efficiency, this reference, 205-206, 207-208 
overloading methods, 132, 188, 188-194 
automatic type promotion, 180-192 
overriding 
final superclass methods, 530-531 
methods, 512 
superclass methods, 511-514 
variables, 183, 183-184 


P 
package(s), 35, 215, 215-216, 583-588. See also 
specific packages 
default, 584 
importing, 218 
package access specifier, 121 
paint() method, 880, 880-882, 895, 920, 961, 
969, 970, 974, 975 
paintComponent() method, 903-905 
paintIcon() method, 972 
painting, 880 
parallel arrays, 418-425, 419 
initializing, 420 
parameters, 127 
actual, 132 
adding to methods, 127-133 
formal, 132 
Graphics objects, 880 
superclasses as method parameter types, 
559-560 
parent classes, 503 
parentheses (()), 39 
method headers, 123-124 
parseDouble() method, 372, 372, 701 
parseFloat() method, 372 
parseInt() method, 220, 370, 370-371, 372, 
701, 710, 716 
parseLong() method, 372 
parsing, 27, 88 


Pascal casing, 15 
passed by reference, 427 
passed by value, 426, 426-427 
passing arguments, 13 
path(s), 677 
absolute, 679, 680-681 
relative, 679, 680-681 
Path class, 677, 677-681, 695 
creating objects, 678-679 
relative, converting to absolute, 680-681 
retrieving information about, 679-680 
path delimiters, 677 
pattern String, 1017 
percent sign (%) 
format specifiers, 1013 
remainder and assign operator, 312 
remainder (modulus) operator, 92, 93, 279, 1024 
permanent storage devices, 676 
PI constant, 216 
pipe (|), logical OR operator, 261, 262, 269, 
279-280 
pixels, 743 
play() method, 977 
plus sign (+) 
add and assign operator, 312 
addition operator, 92, 93, 279 
class diagrams, 501 
concatenation, 57, 365 
postfix increment operator, 312, 313-314, 
314, 315-317, 332-334 
prefix increment operator, 312, 313-314, 314, 
315-317, 332-334 
PNG (Portable Network Graphic), 969 
point size argument, 751 
Point2D.DoubleQ class, 924 
Point2D.Float() class, 924 
polygons, creating, 901-903, 925 
polymorphism, 9, 57, 511, 551 
ad-hoc, 559 
pure (inclusion), 559 
subtype, 512 
populating an array, 404. 
Portable Network Graphic (PNG), 969 
position() method, 704 
postfix decrement operator (postfix --), 313-314, 
314, 315-317, 332-334. 
postfix increment operator (postfix ++), 312, 
313-314, 314, 315-317, 332-334 
posttest loops, 322 








pound sign (#), decimal format objects, 1017 program statements, 2 
pow(x, y) method, 217 programmer-defined data types, 160 
precedence programming 
arithmetic operators, 93, 278-280 object-oriented. See object-oriented 
Boolean operators, 278—280 programming (OOP) 
preferred size, Components, 811 procedural, 5 1079 | 
prefix decrement operator (prefix --), 313-314, promotions, 99 
314, 315-317, 332-334 prompt, 78 
prefix increment operator (prefix ++), 312, properties, 6 
313-314, 314, 315-317, 332-334 objects, 407 
pretest loops, 322 protected access specifier, 121 
prewritten classes, importing, 217—218 protected keyword, 525 
primary key, 147 pseudocode, 242 
primary surface, 828 pseudorandom numbers, 1022 
priming input, 309 public access specifier, 121, 122 
priming reads, 309 public keyword, 16, 19, 525 
primitive data types, 52, 160 public methods, 145, 146 
converting to Strings, 364 pure polymorphism, 559 


printQ© method, 14, 365 
arguments, 60 
displaying variables or constants, 56 


‘ ; uestion mark (?), conditional operator, 
literal Strings contained in, 78 q ) P 


printfQ© function, C programming language, as 
1013 

printfQ method, 1011-1017 R 

optional argument index, 1016, 1016-1017 ragged arrays, 462 

specifying field size, 1015-1016 RAM (random access memory), 676 

specifying number of decimal places random access files, 703-707, 704, 714—729 

to display, 1015 accessing randomly, 715-717, 728-729 
printIn( method, 14, 17, 28, 29, 73-74, 118, displaying statistics, 725-726 
119, 365, 1012 multiple, creating, 718-720 

arguments, 60, 66 reading records sequentially, 714-715, 

displaying characters, 71-72 726-728 

displaying variables or constants, 56 writing records to, 707—713 

method calls from, 135 random access memory (RAM), 676 
printStackTrace() method, 639, 640 Random class, 1022, 1024-1027 
PrintStream class, 14, 66, 691, 692 random() method, 217, 1023 
private access, 143 random numbers, 1021—1027, 1022 
private access specifier, 121, 143 generated by computers, 1022 
private classes, 228 Math. random() method, 1022, 1023-1024 
private keyword, 524-525 Random class, 1022, 1024-1027 
private methods, 145, 146 range checks, 265 
private protected access specifier, 143 accurate, 265-268 
procedural programming, 5 efficient, 268-269 

object-oriented programming compared, 9 range matches, 422 
procedures, 5. See also method(s) searching arrays, 421-423 
program(s). See computer programs read() method, 695, 697, 704 
program comments, 31, 31-34 readAttributes() method, 684 


program files, 676 Reader class, 690, 692 
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ReadFi le class, 695, 696 S 
readLineQ method, 696, 697, 699 sandboxes, 949 
real-time applications, 704 saving 
records, 688, 688-689 classes, 20 
rectangles source code, 998 
| 1080 drawing, 894-897, 924 Scanner class, accepting keyboard input, 76-85 
shadowed, creating, 897-898 scientific notation, 69 
Rectangle2D.Double() class, 924 scope, 56, 180-188 
Rectangle2D.Float() class, 924 variables closer in, 186 
redeclaring variables, 182 variables coming into, 180 
reference(s), 202, 350. See also methods variables going out of, 180 
arrays passed by, 427 screen statistics, 912 
to the object, 151 SDK (Java EE Development Kit), 994 
reference types, 52, 151, 427 searching arrays, 418, 418-425 
list, 52 for range matches, 421-423 
regionMatches() method, 367 seeds, 1022 
relational operators, 68 seekability, file channels, 704 
if statements, 246-427 semantic errors, 4 
relative paths, 679 semicolons (;), if statements, 245-246 
converting to absolute paths, 680-681 sequence structures, 242 
remainder and assign operator (%=), 312 sequential access files, 689, 697-703 
remainder (modulus) operator (%), 92, 93, 279, set Classpath= command, 997 
1024 set() method, ArrayList class, 474 
remove() method, 474, 750, 803 set methods, 153 
removeAl 1Items(), 784 setAlignment() method, 811-812 
removeltem(), 784 setBackground() method, 804, 805 
rename command, 997 setBounds() method, 742, 757 
rendering attributes, Graphics2D class, 920-922 setCharAt() method, 378 
repaint() method, 750, 880, 881, 882 setColor() method, 887, 890, 920 
replace() method, 364 setDefaultCloseOperation( method, 
rerendering, 880 744, 756 
reserved keywords, list, 15 setDefaultLookAndFeelDecorated() 
return clauses, multiple, 135 method, 744-745 
return statements, 133, 134-135, 429 setEditable() method, 760, 784, 785 
void methods, 134 setEnabled() method, 770, 770-771 
return types, 122 setFont() method, 750, 886-887, 890 
return types, 635 setForeground() method, 805 
returning values, 122 setJMenuBar() method, 853 
rewind() method, 705 setLayout() method, 804, 811, 956 
rint (x) method, 217 setLayoutManager() statement, 803 
robustness, 608 setLength() method, 375, 377 
root directory, 676 setLocation() method, 757, 882, 882-884 
round(x) method, 217 setMaximumRowCount() method, 784. 
rounding numbers, 1010-1011 setMnemonic() method, 857-858 
running applications, 28-29 setPaintQ© method, 921 
run-time errors, 31 setResizableQ method, 742 
runtime exceptions, 604 setSelected() method, 780, 855 
RuntimeExceptions, 635 setSelectedIndex() method, 784 


rvalues, 53 setSelectedItemQ method, 784 
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setSize() method, 742, 756 standard arithmetic operators, 91, 91-94, 96-98 
setStroke(Q method, 922, 922-923 associativity and precedence, 93-94, 278-280 
setText() method, 750, 780, 956 standard input devices, 76 
setTitle() method, 742, 756 standard output devices, 14 
setToolTipTextQ© method, 762 StandardOpenOption argument, 694 
setVisible() method, 742, 743-744, 756-757 start(Q method, 957, 961, 962 1081 L 
shadowed rectangles, creating, 897-898 startsWith() method, 364 
shadowing, 184, 184—185 state, 7 
shapes, Graphics2D class, 923-925, 928-930 statements, 13-14. See also specific statements 
short data type, 62, 63 commenting out, 32 

type conversion, 100 empty, 246 
short-circuit evaluation, 262 unreachable, 134 

order, 330 Static access specifier, 143 
show() method, 744 Static fields, 202, 208-215 
showConfirmDialog() method, 89 constants, 210-211 
showInputDialog() method, 85, 85-88, 370 final keyword, 211-215 
showMessageDialog() method, 14, 35, 57 Static import feature, 682 
signatures, methods, 131 static keyword, 19, 88, 122 
significant digits, 69 data fields, 142-143 
simulations, 6 static member classes, 227 
sin(x) method, 217 static method(s), 88, 144-145, 146, 466 
single quotation mark (‘), escape sequence, 73 accepting arguments and returning values, 
single-alternative if, 247 137-138 
single-dimensional arrays, 457 inability of subclasses to override in 
single-precision floating-point numbers, 70 superclasses, 526-530 
size() method, 474, 684, 704 requiring no arguments and returning no 
skipQ© method, 697 values, 124—126 
sleep method, 319 static method binding, 559 
software, 2. See also computer programs stop() method, 962, 977 
software development, inheritance to achieve, storage 

572-573 nonvolatile, 676 

software development kits (SDKs), 37, 994 volatile, 676 
sort() method, 465, 466, 469 streams, 689, 689-690 
sorting, 444 String argument, 360 

bubble sort algorithm, 444—452, 445 String class, 19, 72, 351, 352-353, 357-370, 

insertion sort algorithm, 453, 453-456 700, 701, 914 
sound, adding to applets, 977-980 args identifier, 19 
source, events, 766 comparing, 350-351, 357-361 
source code, 10 comparing Strings, 247 

Notepad, 998 concatenating with numeric values, 56—58 

TextPad, 998-999 converting to double values, 372 
speak() method, 549, 550-551, 558-559, converting to numbers, 370-374 

561-562, 575-577 declaring, 357 

split) method, 701 empty and null Strings, 361-362 
sqrt (x) method, 217 immutability, 358 
square brackets ([]), 39 manipulating arrays, 412 
stack backtrace, 608 nul] elements, 404 
stack trace (stack trace history list), 607 String input, 83-85 


stack traceback, 608 String variables, 357 
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StringBuffer class, 351, 374, 374-375 
StringBui lder class, 351, 374, 374-381 
stringwWidthQ method, 914 
strokes, 922 
strongly typed language, 53 
stubs, 121 
style argument, 751 
subclasses, 503, 508-509 
arrays of subclass objects, 561-564 
inability to override static methods in 
superclasses, 526-530 
subroutines. See method(s) 
subscripts 
arrays, 399, 399-400 
out of bounds, 400 
variable, 406-410 
substring() method, 365 
subtract and assign operator (-=), 312 
subtraction operator (-), 92, 93, 279 
subtype polymorphism, 512 
Sun Microsystems Audio file format (.au), 977 
super keyword, 517 
this keyword compared, 523 
super() method, 517, 756 
superclasses, 503, 507-508 
constructors requiring arguments, 516-517 
as method parameter types, 559-560 
methods, 521-523 
overriding methods, 511-514 
that cannot be overridden, 526-533 
Swing class, 740 
Swing components, 739-793, 740 
adding JButtons, 760-762 
adding JTextFields, 758-760 
associated listener-registering methods, 776 
ButtonGroup class, 781-782 
event listeners, 774—777 
event-driven programming, 774-777 
extending JFrame class, 756-758, 764—765 
JCheckBox class, 778-781, 786-789 
JComboBox class, 782-785 
JFrame class, 741-748 
JLabel class, 748-752 
layout managers, 753, 753-755 
tool tips, 762-763 
Swing containers, Application Programming 
Interface, 832 
switch keyword, 271 
switch statements, 270-276, 271 
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symbolic constants, 54. See also named constants 
syntactic salt, 634 
syntactic sugar, 634. 
syntax, 2 
syntax errors, 3 

correcting, 23-24 

error messages, 23, 27—28 
System class, 14, 35, 141, 215, 692 
system software, 2 
System.err object, 692 
System.exit© statements, 34, 626, 628 
System.getProperty() method, 699, 709 
System. in object, 76, 695 
System. out object, 76, 692, 693 
System.out.formatQ method, 1013 
System.out.printfQ method, 1011-1017, 

1012 

system-triggered painting, 880 


T 
tables, 457 
tag(s) 
HTML, 949, 949-950 
Javadoc, 1030 
tag attributes, 949 
tan(x) method, 217 
temporary variables, 676 
ternary operators, 276 
text files, 676 
TextEvents, 838 
listener and handler, 840 
TextPad, 998-999 
this keyword, super keyword compared, 523 
thisQ© method, 201-208, 202 
calling, 206 
overloaded constructor efficiency, 205-206, 
207-208 
threads of execution, 375 
throw statements, 609, 609-610 
Throwab1e class, 639, 641 
ThrowableException, 612 
throws clause, 634, 635 
Tiger, 994 
toAbsolutePath() method, 680-681 
TOCTTOU bug, 683 
tokens, 76 
toLowerCase() method, 352, 363 
tool tips, 762, 762—763 
Toolkit class, 912 
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ToolTipDemo java file, 763 V 
top-level classes, 227 validate() method, 612, 750, 957 
top-level containers, 802 validating data, 308 
toString() method, 364, 365, 478, 480, 565, loops, 308-311 
566, 566-569, 679 value(s) 
toUpperCase() method, 351, 352, 363 array elements passed by, 426, 426-427 1083 [ 
true value, 243 Boolean, 243 
try blocks, 609, 614-615, 627, 628, 639, 692 character, representation, 1006—1007 
multiple exceptions, 619-621 comma-separated, 689 
try...catch blocks, declaring and initializing denominator, 613 
variables, 616-617 dummy, 471 
try...catch code, 613 false, 243, 404 
try...catch sequences, 610 garbage, 54 
end, 626-628 Ivalues, 53 
two-dimensional arrays, 457, 457-462, 463-465 methods returning, 133-139, 140-141 
length field, 460-461 null, 404 
passing to a method, 460 numeric, representation, 1004—1005 
ragged, 462 passed by, 426-427 
type casting, 100 returning, 122 
type conversion, 99, 99-104. rvalues, 53 
automatic, 99-100 true, 243 
explicit, 100, 100-101, 102-104 type-safe, 483 
implicit, 99, 102-104 Unicode, list, 71-72 
type-ahead buffer, 80 valueOf() method, 371, 372, 480, 482 
typeface argument, 750, 750-751 values() method, 480 
type-safe values, 483 variable(s), 5, 52. See also specific variables 
type-wrapper classes, 88 blocks. See block(s) 
boolean, 67, 67-69 
U class, 209 
UI components, 740. See also Swing closer in scope, 186 
components comparing to constants, 246 
UML. See Unified Modeling Language (UML) declaring, 53-54, 59-62 
unary cast operators, 100 declaring and initializing in 
unary operators, 100 try...catch blocks, 616-617 
unchecked exceptions, 634 decrementing, 305 
Unicode, 15, 1006 holding single value at a time, 58 
values, list, 71-72 incrementing, 305 
Unified Modeling Language (UML), 500 instance, 142 
diagramming inheritance, 500-503 local, 129 
unifying type, 99 overriding, 183, 183-184 
uninitialized variables, 54, 61 redeclaring, 182 
unique identifiers, 148 scope. See scope 
Universal Resource Locators (URLs), 969 shadowing, 184, 184—185 
unnamed constants, 52 temporary, 676 
unreachable statements, 134 uninitialized, 54, 61 
upcasting, 506 using names multiple times, 183 
upper camel casing, 15 variable declarations, 53 
URLs (Universal Resource Locators), 969 viewports, 834 


users, class, 141 virtual classes, 548 
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virtual key codes, 841 WindowListener interface, 775 
virtual method calls, 531 Windows Wave file format (.wav), 977 
void keyword, 19 WORA (“write once, run anywhere”), 10 
voi : seek a work() method, 575-577 
void return type, wrap() method, 704 

| 1084 volatile storage, 676 abies arrays, 704: 
W wrappers, 370 


writeQ© method, 692, 699, 704, 708 


.wav (Windows Wave file format), 977 “write once, run anywhere” (WORA), 10 


Web browsers, 948 


whi le loops, 300, 301, 301-311 X 
altering loop control variable, 303-304, ; 
305-306 x-axis, 845 
definite, 301-303 x-coordinate, 845 
empty body, 304, 304-305 XHTML (eXtensible HyperText Markup 
indefinite, 306-308 Language), 947 
validating data, 308-311 
whitespace, 17 Y 
widgets, 740 y-axis, 845 
wildcard symbol (*), 218 y-coordinate, 845 


Window class, 740-741 

window decorations, 744: 

windowed applications, 11, 11-12 Z 

WindowEvent class, 838, 840, 844 zero, comparing to, 331-332 
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